curl --request POST \
--url https://cloudapi.mailercloud.com/v1/domains \
--header 'Authorization: <api-key>' \
--header 'Content-Type: <content-type>' \
--data '
{
"domain": "example.com"
}
'{
"id": "zjAKXb",
"domain": "example.com",
"status": "not_verified",
"open_tracking": false,
"records": [
{
"type": "CNAME",
"host": "mc.example.com",
"value": "mc3035n.mlrcloud.com",
"status": "pending",
"purpose": "tracking",
"message": "Add the record to your domain provider"
},
{
"type": "CNAME",
"host": "k1._domainkey.example.com",
"value": "dkim.mlrcloud.com",
"status": "pending",
"purpose": "dkim",
"message": "Add the record to your domain provider"
},
{
"type": "CNAME",
"host": "k2._domainkey.example.com",
"value": "dkim2.mlrcloud.com",
"status": "optional",
"purpose": "dkim2",
"message": "Add the record to your domain provider"
},
{
"type": "CNAME",
"host": "img3035n.example.com",
"value": "img3035n.mlrcloud.com",
"status": "pending",
"purpose": "image",
"message": "Add the record to your domain provider"
},
{
"type": "TXT",
"host": "_dmarc.example.com",
"value": "v=DMARC1; p=reject; sp=none; adkim=s; aspf=s; rua=mailto:dmarc@mlrcloud.com; ruf=mailto:dmarc@mlrcloud.com;",
"status": "pending",
"purpose": "dmarc",
"message": "Update the record in your domain provider"
}
],
"created_at": "2026-10-15 18:32:12"
}Add a Domain
Add a sending domain to your account and get the DNS records to publish at your DNS provider. The domain goes through exactly the same checks as Account Settings → Domains in the app (format, blocked and ISP domains, subdomain depth, duplicates and your plan’s domain limit), and the same DNS records are generated.
The response is the same domain object as Get a Domain: status is not_verified and each record is pending (the second DKIM record is optional), with a message saying what to do at your DNS provider. Open tracking is off for a new domain.
After adding the records at your DNS provider, verify the domain from Account Settings → Domains.
Notes
- The domain is case-insensitive and a leading
www.is removed (WWW.Example.comis saved asexample.com). - Subdomains up to 3 levels below the root are allowed (
news.example.com,a.b.c.example.com). - Adding a domain can take a few seconds while its DNS is checked.
Tracking host (mc.)
- For a domain such as
example.com, the tracking record’s host ismc.example.com. - For a subdomain that already exists in your DNS, the host gets a
mc-prefix instead, e.g.mc-news.example.com. mc.example.comis never treated asexample.com. If it is not used as a tracking host, it can be added as its own domain: it keeps its full name and gets its own records (tracking hostmc-mc.example.com).- If
mc.example.comis already the tracking host of an added domain (e.g.example.comwas added first), it cannot be added — the API returns 400 “This domain is already in use or linked elsewhere”.
POST
/
domains
curl --request POST \
--url https://cloudapi.mailercloud.com/v1/domains \
--header 'Authorization: <api-key>' \
--header 'Content-Type: <content-type>' \
--data '
{
"domain": "example.com"
}
'{
"id": "zjAKXb",
"domain": "example.com",
"status": "not_verified",
"open_tracking": false,
"records": [
{
"type": "CNAME",
"host": "mc.example.com",
"value": "mc3035n.mlrcloud.com",
"status": "pending",
"purpose": "tracking",
"message": "Add the record to your domain provider"
},
{
"type": "CNAME",
"host": "k1._domainkey.example.com",
"value": "dkim.mlrcloud.com",
"status": "pending",
"purpose": "dkim",
"message": "Add the record to your domain provider"
},
{
"type": "CNAME",
"host": "k2._domainkey.example.com",
"value": "dkim2.mlrcloud.com",
"status": "optional",
"purpose": "dkim2",
"message": "Add the record to your domain provider"
},
{
"type": "CNAME",
"host": "img3035n.example.com",
"value": "img3035n.mlrcloud.com",
"status": "pending",
"purpose": "image",
"message": "Add the record to your domain provider"
},
{
"type": "TXT",
"host": "_dmarc.example.com",
"value": "v=DMARC1; p=reject; sp=none; adkim=s; aspf=s; rua=mailto:dmarc@mlrcloud.com; ruf=mailto:dmarc@mlrcloud.com;",
"status": "pending",
"purpose": "dmarc",
"message": "Update the record in your domain provider"
}
],
"created_at": "2026-10-15 18:32:12"
}Authorizations
Body
application/json
Response
Created — the domain object, as returned by Get a Domain
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'sstatusisinvalid; see itserror_messagein Get a Domain).
Available options:
verified, not_verified, failed