Skip to main content
PUT

Authorizations

Authorization
string
header
required

Your Mailercloud API key (plain text, no Bearer prefix). Create keys in Settings → API.

Path Parameters

id
string
required

Domain ID (from Add a Domain or List Domains)

Body

application/json
tracking_prefix
string

New host label of the tracking record.

Letters and digits only. Maximum: 25

Main domains only (not subdomains).

Maximum string length: 25
dkim_selector
string

New selector of the dkim record (<selector>._domainkey.<domain>).

Letters and digits only. Maximum: 3

Maximum string length: 3
dkim2_selector
string

New selector of the dkim2 record.

Letters and digits only. Maximum: 3

Maximum string length: 3
image_prefix
string

New host label of the image record.

Letters, digits and dots. Maximum: 25

Maximum string length: 25
open_tracking
boolean

Turn open tracking on (true) or off (false) — the same as the open-tracking toggle in the app. No effect on marketing campaigns.

Response

OK

id
string

Domain ID

domain
string

Domain name

status
enum<string>

Domain status:

  • verified — the domain is authenticated and ready to send.
  • not_verified — the DNS records are not all in place yet (or not checked yet).
  • failed — at least one DNS record was found but is wrong (that record's status is invalid; see its error_message in Get a Domain).
Available options:
verified,
not_verified,
failed
open_tracking
boolean

Open tracking for Email API / SMTP sends from this domain. No effect on marketing campaigns. Off for a newly added domain.

records
object[]

DNS records to publish at your DNS provider

created_at
string

When the domain was added, in your account timezone (YYYY-MM-DD HH:MM:SS)