Skip to content
Start here

Email Sending

Send an email using the builder.
POST/accounts/{account_id}/email/sending/send
Send a raw MIME email message.
POST/accounts/{account_id}/email/sending/send_raw
ModelsExpand Collapse
EmailSendingSendResponse = object { 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 = object { 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 = object { email_sending_enabled, name, tag, 5 more }
email_sending_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
email_sending_dkim_selector: optional string

The DKIM selector used for email signing.

email_sending_return_path_domain: optional string

The return-path domain used for bounce handling.

enabled: optional boolean

Whether Email Routing (receiving) is enabled on this subdomain. Read-only; included for informational purposes since both services share the subdomain row.

modified: optional string

The date and time the destination address was last modified.

formatdate-time
SubdomainGetResponse = object { email_sending_enabled, name, tag, 5 more }
email_sending_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
email_sending_dkim_selector: optional string

The DKIM selector used for email signing.

email_sending_return_path_domain: optional string

The return-path domain used for bounce handling.

enabled: optional boolean

Whether Email Routing (receiving) is enabled on this subdomain. Read-only; included for informational purposes since both services share the subdomain row.

modified: optional string

The date and time the destination address was last modified.

formatdate-time
SubdomainCreateResponse = object { email_sending_enabled, name, tag, 5 more }
email_sending_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
email_sending_dkim_selector: optional string

The DKIM selector used for email signing.

email_sending_return_path_domain: optional string

The return-path domain used for bounce handling.

enabled: optional boolean

Whether Email Routing (receiving) is enabled on this subdomain. Read-only; included for informational purposes since both services share the subdomain row.

modified: optional string

The date and time the destination address was last modified.

formatdate-time
SubdomainDeleteResponse = object { errors, messages, success }
errors: array of object { code, message, documentation_url, source }
code: number
minimum1000
message: string
documentation_url: optional string
source: optional object { pointer }
pointer: optional string
messages: array of object { code, message, documentation_url, source }
code: number
minimum1000
message: string
documentation_url: optional string
source: optional object { 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