DocsLimits & errors ▾
IntroductionQuickstartAuthenticationSending emailDomainsAPI keysSMTP relayWebhooksTemplatesBroadcastsAudiences & contactsSuppression listOpen & click trackingIP warm-upDeliverabilityAnalytics & logsLimits & errorsSelf-hosting & configurationEmailsDomainsAudiences & contactsBroadcastsTemplatesWebhooksAPI keys, suppressions, metrics
Reference
Limits & errors
Rate limit
10 requests per second per API key. Over the limit you get 429 with Retry-After: 1.
Quotas
Monthly and daily email quotas depend on your plan. Exceeding them returns 429 monthly_quota_exceeded or daily_quota_exceeded.
Error format
{
"statusCode": 422,
"name": "validation_error",
"message": "Missing `to` field."
}| Status | name | Meaning |
|---|---|---|
| 400 | invalid_json | Body is not valid JSON |
| 401 | missing_api_key, invalid_api_key | Authentication failed |
| 403 | validation_error, restricted_api_key, sending_paused | Domain not verified, key scope or paused team |
| 404 | not_found | Unknown resource |
| 422 | validation_error | Invalid parameters |
| 429 | rate_limit_exceeded, *_quota_exceeded | Slow down or upgrade |
| 500 | internal_server_error | Our fault, retry with backoff |