Rate limit, timeouts, errors

Rate limits apply to all API requests. Limits are enforced per brand and vary by endpoint. When a rate limit is exceeded the API returns 429 Too Many Requests.

Per-endpoint rate limits

Rate limits are specified in each endpoint's documentation. Common limits are:

Endpoint typeLimit
List (GET collection)100 requests / minute
Create / Update / Delete15 requests / minute
Analytics10 requests / minute, 55 requests / day

Rate limit response

When you exceed a rate limit, the API returns:

{
  "type": "https://problems.omnisend.com/rate-limit-exceeded",
  "title": "Rate limit exceeded",
  "status": 429
}

Wait before retrying. Some endpoints include a retryAfter field (seconds) in the error response.

API errors logs

Errors resulting from API requests are recorded in the API Issues section, accessible via Store Settings > API > API Issues in the Omnisend app. If you encounter unexpected behavior, consult these logs to diagnose and resolve the issue.