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:
API Email + API Key
The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key.
Example:
The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys.
Example:
Send an email
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": "<h1>Hello</h1><p>Please find your report attached.</p>",
"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"
}'{
"errors": [
{
"code": 0,
"message": "message"
}
],
"messages": [
{
"code": 0,
"message": "message"
}
],
"result": {
"delivered": [
"recipient@example.com"
],
"message_id": "<aB3xK9mP2qR5sT8uV0wX1yZ4cD6fG7hJ9kL0@example.com>",
"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
{
"errors": [
{
"code": 0,
"message": "message"
}
],
"messages": [
{
"code": 0,
"message": "message"
}
],
"result": {
"delivered": [
"recipient@example.com"
],
"message_id": "<aB3xK9mP2qR5sT8uV0wX1yZ4cD6fG7hJ9kL0@example.com>",
"permanent_bounces": [
"string"
],
"queued": [
"string"
],
"suppressed_recipients": [
"string"
]
},
"success": true,
"result_info": {
"count": 0,
"per_page": 0,
"total_count": 0,
"cursor": "cursor",
"page": 0
}
}