Charchy Senddocs

Limits

Every size and count limit of the API in one table.

Limit
Recipients per email50 (to + cc + bcc, after duplicates are dropped) — a mail-server limit
reply_to5 addresses
Display name200 characters
Emails per batch100, no attachments
Request body5 MB — attachments are base64, a third bigger than the file
Attachments3 files, 3 MB together (before base64); file name up to 255 characters. Big files belong behind a link
Subject998 characters (RFC 5322)
html, text512 KB each. Gmail clips an email above about 102 KB — stay well under
Tags10 per email; name and value up to 256 characters each
Custom headers20 per email; name up to 76 characters, value up to 998
scheduled_atUp to 30 days ahead
Idempotency keys1–256 printable ASCII characters, kept 24 hours
Requests10 a second per workspace, bursts of 20 — Rate limits
Emails a dayYour workspace's daily cap, per recipient, rolling 24 hours
Test sends1,000 recipients in a rolling 24 hours per workspace, test keys and magic addresses together
Before approval50 recipients in a rolling 24 hours, your team's own addresses only
Hosted images200 per workspace, 2 MB each; PNG, JPEG, GIF, WebP — Images
GET /v1/emails1–100 per page, the last 30 days
Email logEmails and events 30 days, content 7 days after the email was due
Held mailExpired and refunded 3 days past its due time — Scheduling
Webhook endpoints5 per workspace; delivery log 30 days
API keys20 active per workspace (revoked keys don't count)
Sending domains10 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.

On this page