Trigger Zaps from polling webhooks

In order to trigger properly, the Zap expects your URL to return JSON, specifically a list of dictionaries (an array of objects) in reverse chronological order (newest first, oldest last). For example, that might look like this:

[{“id”:1235, “name”:”event2”, “created_date”:”2019-04-01”},{“id”:1234, “name”:”event1”, “created_date”:”2019-01-01”}]

By default, Zapier looks for an “id” key, and uses that to determine whether a record is new or not, i.e. to deduplicate the records.

If the “id” key does not exist by default in your data, you have two options: * You may specify an alternate unique key that the Zap can use for deduplication in the Deduplication Key field. * If you don’t specify an alternate key, the Zap will fall back to the shortest key containing “id”.

Often, the array containing the objects that you’d like to trigger your Zap is not top-level—instead, it may be contained within another object.

If this is the case, use the Key field to enter the key corresponding to the array that does contain the records you’d like to trigger the Zap. Note that this field does support dot notation if the array is nested more than once.

The Retrieve Poll trigger also offers the ability to enter a username and password, Headers, and an Xpath. If your API requires authentication or custom headers to access and parse data properly, you’ll want to take advantage of these fields!