EMAIL API · GUIDE
Email API errors, quotas, and rate limits
Check the HTTP status and error code in the response. Quotas, per-token and per-domain rate limits, and monthly send allowances depend on the active plan.
Common errors
Monthly usage resets at the start of each UTC calendar month. Respect Retry-After when a rate-limit response includes it. Email Logs show send status and linked delivery events when the event watcher is configured.
- 400 invalid_json or invalid_request: check JSON, required fields, recipient addresses, and documented limits.
- 401 unauthorized: check whether the key is missing, invalid, expired, or revoked.
- 402 insufficient_wallet_balance: add funds for the selected plan's recipient charges.
- 403 subscription_inactive or sender_domain_not_verified: check the sender domain and subscription.
- 413 payload_too_large or attachment_too_large: check request and attachment size limits.
- 429 rate_limited or monthly_quota_exceeded: wait and respect plan limits.