Skip to content
Start here

Email Sending

Send an email
POST/accounts/{account_id}/email/sending/send
Send a raw MIME email
POST/accounts/{account_id}/email/sending/send_raw
ModelsExpand Collapse
EmailSendingSendResponse { delivered, permanent_bounces, queued }
delivered: array of string

Email addresses to which the message was delivered immediately.

permanent_bounces: array of string

Email addresses that permanently bounced.

queued: array of string

Email addresses for which delivery was queued for later.

EmailSendingSendRawResponse { delivered, permanent_bounces, queued }
delivered: array of string

Email addresses to which the message was delivered immediately.

permanent_bounces: array of string

Email addresses that permanently bounced.

queued: array of string

Email addresses for which delivery was queued for later.

Email SendingSubdomains

List sending subdomains
GET/zones/{zone_id}/email/sending/subdomains
Get a sending subdomain
GET/zones/{zone_id}/email/sending/subdomains/{subdomain_id}
Create a sending subdomain
POST/zones/{zone_id}/email/sending/subdomains
Delete a sending subdomain
DELETE/zones/{zone_id}/email/sending/subdomains/{subdomain_id}
ModelsExpand Collapse
SubdomainListResponse { enabled, name, tag, 4 more }
enabled: boolean

Whether Email Sending is enabled on this subdomain.

name: string

The subdomain domain name.

tag: string

Sending subdomain identifier.

maxLength32
created: optional string

The date and time the destination address has been created.

formatdate-time
dkim_selector: optional string

The DKIM selector used for email signing.

modified: optional string

The date and time the destination address was last modified.

formatdate-time
return_path_domain: optional string

The return-path domain used for bounce handling.

SubdomainGetResponse { enabled, name, tag, 4 more }
enabled: boolean

Whether Email Sending is enabled on this subdomain.

name: string

The subdomain domain name.

tag: string

Sending subdomain identifier.

maxLength32
created: optional string

The date and time the destination address has been created.

formatdate-time
dkim_selector: optional string

The DKIM selector used for email signing.

modified: optional string

The date and time the destination address was last modified.

formatdate-time
return_path_domain: optional string

The return-path domain used for bounce handling.

SubdomainCreateResponse { enabled, name, tag, 4 more }
enabled: boolean

Whether Email Sending is enabled on this subdomain.

name: string

The subdomain domain name.

tag: string

Sending subdomain identifier.

maxLength32
created: optional string

The date and time the destination address has been created.

formatdate-time
dkim_selector: optional string

The DKIM selector used for email signing.

modified: optional string

The date and time the destination address was last modified.

formatdate-time
return_path_domain: optional string

The return-path domain used for bounce handling.

SubdomainDeleteResponse { errors, messages, success }
errors: array of { code, message, documentation_url, source }
code: number
minimum1000
message: string
documentation_url: optional string
source: optional { pointer }
pointer: optional string
messages: array of { code, message, documentation_url, source }
code: number
minimum1000
message: string
documentation_url: optional string
source: optional { pointer }
pointer: optional string
success: true

Whether the API call was successful.

Email SendingSubdomainsDNS

Get sending subdomain DNS records
GET/zones/{zone_id}/email/sending/subdomains/{subdomain_id}/dns