Rate limits

Requests are limited per API key, in a one-minute window. Reads and writes have separate budgets.

When a key goes over its budget, the API answers 429 until the window resets:

{
  "errors": [{ "message": "Too many requests", "code": "E_TOO_MANY_REQUESTS" }]
}

The response carries Retry-After (seconds to wait) and the X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset headers. Read them instead of hard-coding the numbers above, which may change.

Staying within the limitsCopy Anchor Link

• Page with perPage=100 to cut the number of calls.
• Use webhooks rather than polling for changes.
• On 429, wait for Retry-After and retry. On 5xx, retry with exponential backoff and jitter.
• Spread bulk imports over time instead of sending them in one burst.