Email Setup Records

This is not the live zone view. This endpoint returns only the email-provider setup records (MX/TXT/CNAME) that the customer needs to add at their registrar to pass email-domain verification. To see (or modify) every record currently on the live DNS zone, use the /zone-records endpoints instead.

{ "domain": "mycompany.com", "domain_id": "domain-uuid", "status": "pending_dns", "dns_status": "pending_verification", "records": [ { "type": "MX", "name": "mycompany.com", "value": "feedback-smtp.usenaive.email", "priority": 10, "status": "verified" }, { "type": "TXT", "name": "mycompany.com", "value": "v=spf1 include:usenaive.email ~all", "status": "pending" }, { "type": "CNAME", "name": "naive._domainkey.mycompany.com", "value": "naive.domainkey.example.com", "status": "pending" } ] }

Status	Meaning
`verified`	Record confirmed in DNS
`pending`	Record not yet detected

Status

Meaning

verified

Record confirmed in DNS

pending

Record not yet detected

Compared to /zone-records

Endpoint	Returns	Mutable?
`GET /v1/domains/:id/dns-records` (this)	Just the email setup records (MX/TXT/CNAME) needed to pass verification	No
`GET /v1/domains/:id/zone-records`	Every record currently on the live DNS zone, with provider record IDs	Yes (via POST/DELETE)

The MCP tool for this endpoint is naive_resend_setup_records. The MCP tools for the live zone are naive_list_dns_records, naive_set_dns_record, and naive_delete_dns_record.

​Record Statuses

​Notes

​Compared to /zone-records

Record Statuses

Notes

Compared to `/zone-records`