Rate limits · Email
Email endpoints use the shared rate-limit model — org-level limits, group-based buckets, IETF RateLimit headers, and 429 + Retry-After on exhaustion. This page covers the email-specific groups and numbers. All windows are 1 minute and fixed; only the rate varies by tier or override.
Send limits
Sending has two dedicated groups, so send quota is never consumed by management traffic (or vice versa):
| Group | Endpoint | Base limit | What counts |
|---|---|---|---|
| email_send | POST /v1/email/messages | 10/min | One request = one message (to its explicit recipient list). |
| email_batch | POST /v1/email/batches | 5/min | One request = up to 100 independent messages, queued at once. |
The limits count requests, not recipients — which makes batching the lever for volume. At base limits, single sends top out at 10 messages per minute, while 5 batch calls can queue up to 500 messages in the same window. If you are sending to many recipients, move to the batch endpoint before reaching for a higher tier — see Sending in bulk.
Management limits
Most non-send operations — listing messages, reading delivery status, managing domains, webhooks, and suppressions — use the generic management groups shared across the API:
| Group | Covers | Base limit |
|---|---|---|
| list | Collection queries: list messages, message events, recipients, domains, suppressions. | 150/min |
| read | Single-resource lookups: a message by ID, a domain, a webhook, a suppression. | 500/min |
| write | Creates, updates, and deletes: domains, webhooks, suppressions, IP pools. | 60/min |
list and read rise with your subscription tier — see Tiers raise your limits below. write stays at its base rate for every tier.
The RateLimit header on each response names the group that matched, so a 429 always tells you which of these buckets you exhausted:
Ejemplo de código
RateLimit: "email_send";r=0;t=35Tiers raise your limits
Your subscription tier raises the send, batch, and read-heavy management limits:
| Tier | email_send | email_batch | list | read |
|---|---|---|---|---|
| Free | 10/min | 5/min | 150/min | 500/min |
| Startup | 100/min | 25/min | 300/min | 1,000/min |
| Growth | 1,000/min | 100/min | 750/min | 2,000/min |
| Custom | By arrangement | By arrangement | By arrangement | By arrangement |
write keeps its base rate (60/min) at every tier — domain, webhook, and suppression management doesn't scale with send volume. Custom-tier ceilings are set by arrangement, and if your throughput outgrows even those, per-organization overrides can raise any group further — contact support.
Related
- Rate limits — the shared model: headers, resolution, and handling 429s
- Sending in bulk — using batches to send to many recipients per request
- Billing & usage — subscription tiers
- Email messages API reference — send endpoint documentation