API reference

Rate limits

LimitValue
Requests600 per minute per API key
Emails per batch100
Recipients per email50 across to, cc and bcc
Attachments40 MB per email, decoded
Idempotency keysremembered for 24 hours
Monthly emailsyour plan’s volume, shared with campaigns

When you hit the limit

Requests over the limit get 429 Too Many Requests with a Retry-After header. Wait that many seconds, then retry with the same Idempotency-Key.

To send many emails quickly, use batches: one request carries up to 100 emails, so 600 requests a minute can queue up to 60,000 emails.

Plan volume

Emails sent through the API count toward your plan’s monthly volume, together with campaigns and automations. See pricing.