---
title: Send an email
---
[Skip to content](#_top)
[API Reference](https://developers.cloudflare.com/api)
[Email Sending](https://developers.cloudflare.com/api/resources/email_sending)
Copy Markdown
Open in **Claude**Open in **ChatGPT**Open in **Cursor**
---
**Copy Markdown****View as Markdown**
# Send an email
POST/accounts/{account\_id}/email/sending/send
Send an email for the specified account using the structured builder. Provide the sender, recipients, subject, and at least one of text or html; attachments are optional.
##### Security
API Token
The preferred authorization scheme for interacting with the Cloudflare API. Create a token.
**Example:**Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY
API Email + API Key
The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key.
**Example:**X-Auth-Email: user@example.com
The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys.
**Example:**X-Auth-Key: 144c9defac04969c7bfad8efaa8ea194
##### P ath ParametersExpand Collapse
account\_id: string
Identifier of the account.
[Link to this property](<#(resource)%20email_sending%20%3E%20(method)%20send%20%3E%20(params)%20default%20%3E%20(param)%20account_id%20%3E%20(schema)>)
##### Body ParametersJSONExpand Collapse
body:
[Link to this property](<#(resource)%20email_sending%20%3E%20(method)%20send%20%3E%20(params)%200%20%3E%20(param)%20body%20%3E%20(schema)>)
##### ReturnsExpand Collapse
errors: array of object {code, message }
code: number
Link to this property
message: string
Link to this property
[Link to this property](<#(resource)%20email_sending%20%3E%20(method)%20send%20%3E%20(network%20schema)%20%3E%20(property)%20errors>)
messages: array of object {code, message }
code: number
Link to this property
message: string
Link to this property
[Link to this property](<#(resource)%20email_sending%20%3E%20(method)%20send%20%3E%20(network%20schema)%20%3E%20(property)%20messages>)
result: object {delivered, message\_id, permanent\_bounces, 2 more }
delivered: array of string
Email addresses to which the message was delivered immediately.
Link to this property
message\_id: string
Message ID of the sent email.
Link to this property
permanent\_bounces: array of string
Email addresses that permanently bounced.
Link to this property
queued: array of string
Email addresses for which delivery was queued for later.
Link to this property
suppressed\_recipients: array of string
Email addresses dropped because they are on the suppression list. Returned when suppressed-recipient dropping is enabled for the sending subdomain; otherwise the request fails instead.
Link to this property
[Link to this property](<#(resource)%20email_sending%20%3E%20(method)%20send%20%3E%20(network%20schema)%20%3E%20(property)%20result>)
success: true
[Link to this property](<#(resource)%20email_sending%20%3E%20(method)%20send%20%3E%20(network%20schema)%20%3E%20(property)%20success>)
result\_info: optional object {count, per\_page, total\_count, 2 more }
count: number
Link to this property
per\_page: number
Link to this property
total\_count: number
Link to this property
cursor: optional string
Link to this property
page: optional number
Link to this property
[Link to this property](<#(resource)%20email_sending%20%3E%20(method)%20send%20%3E%20(network%20schema)%20%3E%20(property)%20result_info>)
### Send an email
HTTP
HTTPTypeScriptPythonGoTerraform
```
curl https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/email/sending/send \
-H 'Content-Type: application/json' \
-H "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
-d '{
"attachments": [
{
"content": "JVBERi0xLjQK...",
"disposition": "attachment",
"filename": "report.pdf",
"type": "application/pdf"
}
],
"from": "sender@example.com",
"html": "Hello
Please find your report attached.
",
"subject": "Monthly Report",
"text": "Hello\\n\\nPlease find your report attached.",
"to": [
"recipient@example.com"
],
"bcc": [
"bcc-recipient@example.com"
],
"cc": [
"cc-recipient@example.com"
],
"headers": {
"X-Custom-Header": "value"
},
"reply_to": "replies@example.com"
}'
```
200 example
```
{
"errors": [
{
"code": 0,
"message": "message"
}
],
"messages": [
{
"code": 0,
"message": "message"
}
],
"result": {
"delivered": [
"recipient@example.com"
],
"message_id": "",
"permanent_bounces": [
"string"
],
"queued": [
"string"
],
"suppressed_recipients": [
"string"
]
},
"success": true,
"result_info": {
"count": 0,
"per_page": 0,
"total_count": 0,
"cursor": "cursor",
"page": 0
}
}
```
##### Returns Examples
200 example
```
{
"errors": [
{
"code": 0,
"message": "message"
}
],
"messages": [
{
"code": 0,
"message": "message"
}
],
"result": {
"delivered": [
"recipient@example.com"
],
"message_id": "",
"permanent_bounces": [
"string"
],
"queued": [
"string"
],
"suppressed_recipients": [
"string"
]
},
"success": true,
"result_info": {
"count": 0,
"per_page": 0,
"total_count": 0,
"cursor": "cursor",
"page": 0
}
}
```