Skip to content
Start here

Subdomains

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.

SubdomainsDNS

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