Update perform method for polling trigger
Change scenario
It is generally safe to update a polling trigger’s perform method (Platform CLI) or API Configuration (Platform UI), as long as the changes maintain backward compatibility in the returned response data. This means that the output fields and output data structure should remain consistent with previous version’s.
Impact to users
Updating a polling trigger’s perform method or API Configuration might cause deduplication issues and cause old records to trigger a Zap if any of the following changes occur:
- The dedupe ID field (usually
id
) is changed or removed from the API response. - The perform method’s endpoint is modified, resulting in fundamental changes to the dedupe ID value.
For example, if the API or endpoint previously returned dedupe IDs as integers -1,2,3,4 - and is now updated to return alphanumeric values - 1-abc, 2-bcd, 3-cde, 4-def - records that were previously processed will fire again since the new IDs aren’t saved in the deduplication table that Zapier references during each poll.
Best practices
- Ensure the dedupe ID key remains unchanged: If the API response changes the dedupe ID key, use custom code to maintain consistency and prevent deduplication issues.
- Maintain reverse chronological order: the trigger should continue to return data in reverse chronological order to prevent unintended records triggering the Zap.