​
Throttling by your API

​
Constraint

Your API has request limits.

​
Errors user will see if constraint is hit

  • If a trigger, user will receive an email with an error message about the trigger error
  • If an action, user will see an error in Zap history

​
Best practice

Add a specific Retry-After header to your 429 response, or specify a timed delay in your error response using a special ThrottledError. Instead of a user’s Zap erroring and halting, the request will be retried at the specified time. More on the retry here. The user will see a Waiting/Scheduled message in Zap history instead of an error while the limit is still in place.
If implementing a ThrottledError, you could consider implementing a jitter for handling 429 errors, that could look something like this to randomize the frequency of the retries as well: throw new z.errors.ThrottledError('message here', 60 + Math.floor(Math.random() * 60)) Keep in mind that adding custom error handling with ThrottledError would likely require a new integration version, whereas adding to the headers could be implemented on your API’s end.

​
Webhook throttles by Zapier

​
Constraint

Zapier’s current webhook limits are here. A 429 response is returned if your integration exceeds these limits in number of webhooks sent to Zapier.

​
Errors user will see if constraint is hit

  • User will receive an email with an error message about the trigger error

​
Best practice

You should support a retry/back-off schedule to make sure the data is eventually received.

​
Polling trigger throttles by Zapier

​
Constraint

There is a default limit of 100 new items recognized per poll after deduplication. More on that here.

​
Errors user will see if constraint is hit

  • The user will receive an email about held Zap runs, as well as a banner with the same information in their Zap history.

​
Best practice

If your trigger will be returning > 100 new records consistently, consider converting your trigger to be REST Hook based. Webhook limits are higher (up to 10,000 requests in a 5 minute period).
Need help? Tell us about your problem and we’ll connect you with the right resource or contact support.