Rate Limits define the maximum number of requests that can be made by apps to the Shape REST API in a given period of time. Please refer to the “Limits” section on the billing and transactions tab to review your system’s API limits. Shape employs rate limits to ensure stability of the API service for all users and to prevent many types of abuse or inadvertent usage.
Rate limits are applied at the account level. Rate limits will be shared by all apps created and installed on an account using the open API. When the limit is exceeded, an API request will fail and an HTTP 429 status code will be returned.
When you exceed the rate limits allowed for an API request, you will receive a “429 Too Many Requests” error. The best way to handle rate limits is to be on the lookout for 429 status codes and build in a retry mechanism that makes reduced number of requests to the server in a given timeframe. If you’re trying to pull or update multiple contacts in a short timeframe, try a bulk API request instead of the individual requests to avoid a 429 error message.
Cache responses whenever possible instead of frequently making the same request. We also highly recommend that you use webhooks instead of polling for changes whenever applicable. Instead of making repeated calls to pull data frequently from the Shape API, you can use webhooks to get information on events that happen in Shape.
To prevent abuse and handle API request traffic efficiently, we may alter these limits if required.
