Skip to navigation

Rate Limits

View as Markdown

Limits

ConstraintLimit
Sustained request rate1 request/second (60 per minute)
Burst request rate2 requests/second (120 per minute)
Items per batch50 max
Request body size1 MB max

When you exceed a limit

ScenarioResponse
Too many requests429 Too Many Requests
Payload too large413 Payload Too Large
Invalid payload422 Unprocessable Entity

Batching strategy

  • Send as few requests as possible, with as many records per request as the batch limit allows (up to 50). At 1 request per second sustained, one request of 50 records beats 50 requests of 1 record: batching is the difference between seconds and minutes for a large sync.
  • Retry on network failures or 5xx errors. On 429, back off before retrying.
  • Don’t retry other 4xx responses without fixing the request first.