Verify email domains

A registered domain must be verified before use to ensure email delivery and ownership of the domain. Verification is done by adding specific DNS records to the domain's name server.

Check verification status/instructions

Endpoint: GET domains/{domain}/verification

This endpoint returns the verification status of the domain. If the verification status is false, the next missing/required DNS records will be provided.

Response data type

{ "domain": "example.com", "spf": { "valid": false, "requiredKey": "example.com", "requiredEntry": "v=spf1 include:spf.mandrillapp.com include:mailgun .org ?all" }, "dkim": { "valid": false, "requiredKey": "mailo._domainkey.example.com", "requiredEntry": "v=DKIM1; k=rsa; p=MIGfMA0GCSqGSIb3DQEBAQU..." }, "verification": { "valid": false, "requiredKey": "email.example.com", "requiredEntry": "mailgun.org" }, "lastChecked": "2018- 10-23T17:43:19Z" }

domain

The domain that the verification status is about.

spf

Part of the domain's security. Should be a TXT record in DNS.

dkim

The second part of the domain's security. Should be a TXT record in DNS.

verification

The ownership verification of the domain. If the record is a domain name it should be a CNAME record otherwise it should be a TXT record in DNS

valid

If this part of the verification is valid.

requiredKey

The DNS record key needed to verify that part. Omitted if already valid.

requiredEntry

The DNS record value needed to verify that part. Omitted if already valid.