--- description: Send emails from any application using the Email Service REST API with standard HTTP requests. title: REST API image: https://developers.cloudflare.com/og-docs.png --- [Skip to content](#main-content) > Documentation Index > Fetch the complete documentation index at: https://developers.cloudflare.com/email-service/llms.txt > Use this file to discover all available pages before exploring further. # REST API Last updated Aug 31, 2026|Copy as Markdown| [View as Markdown](https://fec4cfc0.previews.developers.cloudflare.com/email-service/api/send-emails/rest-api/index.md)| [Agent setup](https://fec4cfc0.previews.developers.cloudflare.com/agent-setup/) The REST API allows you to send emails from any application using a standard HTTP request to `POST /accounts/{account_id}/email/sending/send`. Use it from any backend, serverless function, or CI/CD pipeline — no Cloudflare Workers binding is required. For the full OpenAPI specification, refer to the [Email Sending API reference](https://fec4cfc0.previews.developers.cloudflare.com/api/resources/email_sending/methods/send/). Cloudflare also provides official SDKs for the REST API: [Node](https://fec4cfc0.previews.developers.cloudflare.com/api/node/), [Python](https://fec4cfc0.previews.developers.cloudflare.com/api/python/), and [Go](https://fec4cfc0.previews.developers.cloudflare.com/api/go/). ## Authentication Authenticate with a [Cloudflare API token](https://fec4cfc0.previews.developers.cloudflare.com/fundamentals/api/get-started/create-token/) that has permission to send emails. Include it in the `Authorization` header: ```txt Authorization: Bearer ``` ## Send an email ```bash curl "https://api.cloudflare.com/client/v4/accounts/{account_id}/email/sending/send" \ --header "Authorization: Bearer " \ --header "Content-Type: application/json" \ --data '{ "to": "recipient@example.com", "from": "welcome@yourdomain.com", "subject": "Welcome to our service!", "html": "

Welcome!

Thanks for signing up.

", "text": "Welcome! Thanks for signing up." }' ``` For multiple recipients, CC/BCC, and named addresses, see [Specify recipients](https://fec4cfc0.previews.developers.cloudflare.com/email-service/examples/email-sending/recipients/). ## Attachments Send files by including base64-encoded content in the `attachments` array. The total message size must not exceed **5 MiB** (including attachments). ```bash curl "https://api.cloudflare.com/client/v4/accounts/{account_id}/email/sending/send" \ --header "Authorization: Bearer " \ --header "Content-Type: application/json" \ --data '{ "to": "customer@example.com", "from": "invoices@yourdomain.com", "subject": "Your Invoice", "html": "

Invoice attached

Please find your invoice attached.

", "attachments": [ { "content": "JVBERi0xLjQKJeLjz9MK...", "filename": "invoice-12345.pdf", "type": "application/pdf", "disposition": "attachment" } ] }' ``` For inline images and file uploads, see [Email attachments](https://fec4cfc0.previews.developers.cloudflare.com/email-service/examples/email-sending/email-attachments/). ## Custom headers Set custom headers for threading, list management, or tracking. Refer to the [email headers reference](https://fec4cfc0.previews.developers.cloudflare.com/email-service/reference/headers/) for the full list of allowed headers. ```bash curl "https://api.cloudflare.com/client/v4/accounts/{account_id}/email/sending/send" \ --header "Authorization: Bearer " \ --header "Content-Type: application/json" \ --data '{ "to": "user@example.com", "from": "notifications@yourdomain.com", "subject": "Your weekly digest", "html": "

Weekly Digest

", "headers": { "List-Unsubscribe": "", "List-Unsubscribe-Post": "List-Unsubscribe=One-Click", "X-Campaign-ID": "weekly-digest-2026-03" } }' ``` ## Response A successful response returns the delivery status for each recipient: ```json { "success": true, "errors": [], "messages": [], "result": { "delivered": ["recipient@example.com"], "permanent_bounces": [], "queued": [] } } ``` - `delivered` - Email addresses to which the message was delivered immediately - `permanent_bounces` - Email addresses that permanently bounced - `queued` - Email addresses for which delivery was queued for later Workers binding vs REST API responses The REST API returns recipient-grouped delivery status. The [Workers binding](https://fec4cfc0.previews.developers.cloudflare.com/email-service/api/send-emails/workers-api/) returns a single `messageId` per `send()` call instead. ## Error handling The REST API returns standard Cloudflare API error responses. A failed request returns an `errors` array with numeric error codes and machine-readable messages: ```json { "success": false, "errors": [ { "code": 10001, "message": "email.sending.error.invalid_request_schema" } ], "messages": [], "result": null } ``` REST API error codes: | HTTP Status | Code | Message | Description | | --- | --- | --- | --- | | 400 | 10001 | `email.sending.error.invalid_request_schema` | Invalid request format | | 400 | 10200 | `email.sending.error.email.too_big` | Email exceeds size limit | | 400 | 10201 | `email.sending.error.email.no_content_length` | Missing content length | | 400 | 10202 | `email.sending.error.email.invalid` | Invalid email content | | 401 | 10101 | `email.sending.error.authentication.unauthorized` | Missing or invalid API token | | 401 | 10103 | `email.sending.error.authentication.bad_token_type` | Wrong token type for this endpoint | | 403 | 10102 | `email.sending.error.authentication.forbidden` | Token lacks permission to send | | 403 | 10105 | `email.sending.error.authentication.not_entitled` | Account not entitled to use Email Sending | | 403 | 10203 | `email.sending.error.email.sending_disabled` | Sending disabled for this zone or account | | 404 | 10000 | `email.sending.error.not_found` | Resource not found | | 429 | 10004 | `email.sending.error.throttled` | Rate limit exceeded | | 500 | 10002 | `email.sending.error.internal_server` | Internal server error | | 500 | 10003 | `email.sending.error.not_implemented` | Operation not implemented | | 503 | 10100 | `email.sending.error.authentication.upstream` | Authentication service temporarily unavailable | Workers binding vs REST API errors The REST API returns standard Cloudflare API numeric error codes, while the [Workers binding](https://fec4cfc0.previews.developers.cloudflare.com/email-service/api/send-emails/workers-api/) throws errors with string codes (for example, `E_SENDER_NOT_VERIFIED`). Refer to the [Workers API error codes table](https://fec4cfc0.previews.developers.cloudflare.com/email-service/api/send-emails/workers-api/#error-codes) for the string error codes. ## Next steps - Refer to the [Email Sending API reference](https://fec4cfc0.previews.developers.cloudflare.com/api/resources/email_sending/methods/send/) for the full request and response schemas. - See the [Workers API](https://fec4cfc0.previews.developers.cloudflare.com/email-service/api/send-emails/workers-api/) for sending emails directly from Cloudflare Workers using bindings. - See [SMTP](https://fec4cfc0.previews.developers.cloudflare.com/email-service/api/send-emails/smtp/) for sending from any SMTP-capable application or mail client. - Review [email headers](https://fec4cfc0.previews.developers.cloudflare.com/email-service/reference/headers/) for threading, list management, and custom tracking headers. Was this helpful? YesNo ## On this page [![](https://fec4cfc0.previews.developers.cloudflare.com/_astro/logo.te5VL_aD.svg)Docs](https://fec4cfc0.previews.developers.cloudflare.com/) ```json {"@context":"https://schema.org","@type":"TechArticle","@id":"https://developers.cloudflare.com/email-service/api/send-emails/rest-api/#page","headline":"REST API · Cloudflare Email Service docs","description":"Send emails from any application using the Email Service REST API with standard HTTP requests.","url":"https://developers.cloudflare.com/email-service/api/send-emails/rest-api/","inLanguage":"en","image":"https://developers.cloudflare.com/og-docs.png","dateModified":"2026-08-31","publisher":{"@type":"Organization","name":"Cloudflare","description":"One platform for your apps, agents, and workforce. Build, secure, and scale without managing infrastructure","url":"https://www.cloudflare.com/","sameAs":["https://github.com/cloudflare","https://www.linkedin.com/company/cloudflare","https://x.com/cloudflare"],"logo":{"@type":"ImageObject","url":"https://developers.cloudflare.com/logo.svg"},"address":{"@type":"PostalAddress","streetAddress":"101 Townsend St","addressLocality":"San Francisco","addressRegion":"CA","postalCode":"94107","addressCountry":"US"},"contactPoint":[{"@type":"ContactPoint","contactType":"Customer Support","url":"https://support.cloudflare.com/","availableLanguage":["English"]},{"@type":"ContactPoint","contactType":"Sales","url":"https://www.cloudflare.com/contact/","availableLanguage":["English"]}]},"isPartOf":{"@type":"WebSite","@id":"https://developers.cloudflare.com/#website","name":"Cloudflare Docs","url":"https://developers.cloudflare.com/"}} ```