API basics
Errors
What went wrong and how to fix it.
Errors are JSON with an HTTP status, a machine-readable name and a human message:
{ "statusCode": 422, "name": "validation_error", "message": "Missing `to` field" }| Status | Name | Meaning |
|---|---|---|
| 400 | invalid_json | The body isn't valid JSON |
| 401 | missing_api_key | No Authorization: Bearer pw_… header |
| 401 | restricted_api_key | A sending-only key called a non-sending endpoint |
| 402 | payment_required | The last payment failed; update your card |
| 403 | invalid_api_key | The key doesn't exist or was revoked |
| 403 | validation_error | e.g. the from domain isn't verified |
| 403 | plan_limit | Your plan's domain/webhook limit is reached |
| 404 | not_found | The resource doesn't exist on your team |
| 409 | validation_error | Duplicate (e.g. domain already added) |
| 422 | validation_error | A field is missing or invalid |
| 429 | rate_limit_exceeded | Too many requests per second |
| 429 | daily_quota_exceeded / monthly_quota_exceeded | Plan limit reached |
| 500 | application_error | Something went wrong on our side; retry |
Was this page helpful?Send feedback