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 primary key (usually an id field) is changed or removed from the API response.
  • The perform method’s endpoint is modified, resulting in fundamental changes to the primary key 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 primary key remains unchanged: If the API response changes the primary 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.

Need help? Tell us about your problem and we’ll connect you with the right resource or contact support.