Skip to main content

Limits

LimitValue
Requests per second2 per organization
Recipients per request50 email addresses
Message length4000 characters
When the rate limit is exceeded, the API returns:
{
  "status": "error",
  "details": "Rate limit exceeded (2 requests/second)"
}
HTTP status: 429 Too Many Requests Header: Retry-After: 1

Best practices

  • Batch recipients — Send to multiple users in a single request instead of making separate calls per user
  • Respect Retry-After — Wait the indicated number of seconds before retrying
  • Use callbacks — For interactive notifications, use callback_url instead of polling the status endpoint repeatedly
  • Cache responses — Status endpoint results can be cached for a few seconds to avoid unnecessary calls