Current documented limits
| Constraint | Current value | Scope | Verified source |
|---|---|---|---|
| total message sizeThe complete request message, including encoded attachments, must remain below the ceiling. | Less than 30 MB | Mail Send API | Twilio SendGridAug 22, 2026 |
| recipients per Mail Send requestThe reply_to_list also has a documented 1,000-entry limit. | 1,000 | Mail Send API | Twilio SendGridAug 22, 2026 |
| endpoint-specific API rateSendGrid documents 429 handling without publishing one universal number for every endpoint. | Endpoint specific; exposed in rate-limit headers | v3 API | Twilio SendGridAug 22, 2026 |
How to apply SendGrid limits safely
The monitored baseline covers total message size, recipients per Mail Send request, endpoint-specific API rate. Treat these as separate constraints rather than one platform-wide capacity number: a workload can fit one row and still fail another because the plan, model, endpoint, runtime, region, invocation mode, or account scope differs.
- Match the production workload to the exact scope printed beside each value and confirm it in the active SendGrid console, configuration, or response headers.
- Measure the serialized request, token volume, duration, concurrency, storage, or connection demand at realistic percentiles, then preserve headroom for bursts and retries.
- Check every adjacent layer—client, SDK, gateway, proxy, queue, database, and downstream service—for a smaller effective limit before changing architecture.
Specific limit pages
These pages exist because the constraint has a distinct implementation or troubleshooting intent. Closely related keyword variations stay consolidated.
SendGrid Mail Send Message Size Limit
SendGrid Mail Send Message Size Limit, verified against SendGrid's official documentation with scope, implementation impact, caveats, and a direct check.
SendGrid Recipient Limit per Request
SendGrid Recipient Limit per Request, verified against SendGrid's official documentation with scope, implementation impact, caveats, and a direct check.
SendGrid API Rate-Limit Headers
SendGrid API Rate-Limit Headers, verified against SendGrid's official documentation with scope, implementation impact, caveats, and a direct check.