Errors
Every error has the same shape, and a stable name to branch on.
{
"statusCode": 422,
"name": "validation_error",
"message": "Invalid `subject` field. The `subject` field is required."
}Some errors add details. For example, domain_in_use says whether the domain can be claimed.
| Status | name | What it means |
|---|---|---|
| 400 | invalid_idempotency_key | The Idempotency-Key header is empty or longer than 256 characters. |
| 401 | missing_api_key | No API key was sent. |
| 401 | restricted_api_key | A sending-only key called another endpoint, or a domain it isn't allowed to use. |
| 403 | invalid_api_key | The key doesn't exist or was revoked. |
| 403 | no_access | The Developer API isn't turned on for the account. |
| 403 | domain_not_verified | The from domain isn't verified on your account. |
| 403 | suspended | Sending is paused because of a high bounce or complaint rate. |
| 403 | plan_limit_reached | Your plan's limit for domains, keys, webhooks, contacts or segments is reached. |
| 404 | not_found | The resource or path doesn't exist. |
| 409 | conflict | Already exists or already in progress, e.g. a domain you've added or an email that's being sent. |
| 409 | idempotency_conflict | The same idempotency key with a different body, or still in flight. |
| 409 | domain_in_use | Another iResendly account holds the domain. |
| 422 | validation_error | The body or parameters are invalid; the message says which field. |
| 422 | invalid_from_address | from isn't a valid address. |
| 422 | application_error | The email was refused by the delivery provider. |
| 429 | rate_limit_exceeded | Too many requests this second. Wait for retry-after. |
| 429 | daily_quota_exceeded | The Free plan's daily limit is used up. |
| 429 | monthly_quota_exceeded | This month's emails are used up. |
| 500 | internal_server_error | Something went wrong on our side. Retry with the same idempotency key. |
| 502 · 503 | application_error | A provider is temporarily unavailable. Retry later. |
Still stuck? Write to us and we'll reply by email.Contact ussupport@iresendly.com