Limits
Every size and count limit of the API in one table.
| Limit | |
|---|---|
| Recipients per email | 50 (to + cc + bcc, after duplicates are dropped) — a mail-server limit |
reply_to | 5 addresses |
| Display name | 200 characters |
| Emails per batch | 100, no attachments |
| Request body | 5 MB — attachments are base64, a third bigger than the file |
| Attachments | 3 files, 3 MB together (before base64); file name up to 255 characters. Big files belong behind a link |
| Subject | 998 characters (RFC 5322) |
html, text | 512 KB each. Gmail clips an email above about 102 KB — stay well under |
| Tags | 10 per email; name and value up to 256 characters each |
| Custom headers | 20 per email; name up to 76 characters, value up to 998 |
scheduled_at | Up to 30 days ahead |
| Idempotency keys | 1–256 printable ASCII characters, kept 24 hours |
| Requests | 10 a second per workspace, bursts of 20 — Rate limits |
| Emails a day | Your workspace's daily cap, per recipient, rolling 24 hours |
| Test sends | 1,000 recipients in a rolling 24 hours per workspace, test keys and magic addresses together |
| Before approval | 50 recipients in a rolling 24 hours, your team's own addresses only |
| Hosted images | 200 per workspace, 2 MB each; PNG, JPEG, GIF, WebP — Images |
GET /v1/emails | 1–100 per page, the last 30 days |
| Email log | Emails and events 30 days, content 7 days after the email was due |
| Held mail | Expired and refunded 3 days past its due time — Scheduling |
| Webhook endpoints | 5 per workspace; delivery log 30 days |
| API keys | 20 active per workspace (revoked keys don't count) |
| Sending domains | 10 per workspace |
Not supported
- SMTP — HTTP API only.
- Stored templates — render the email in your app and send the HTML.
- Receiving email through the API.
- Open and click tracking.
- Marketing email — use Charchy Campaigns. See What counts as transactional.