latestOpenAPI 3.1.0MIT2026-08-22113168358.0 KB

2d06ad0e0bc3

Domains

Add DNS Record

Add a DNS record to a domain bought in Migma, for example Google Workspace MX records, a site-verification TXT, or an A record pointing a subdomain at a server. Migma's email sending records are protected and managed automatically, duplicate SPF or DMARC records are refused, the root and www names are reserved for domain forwarding, and each domain is capped at 50 records. Returns 404 if the domain's DNS zone is not hosted by Migma. Requires API key with domain:write permission.

post/v1/domains/{domain}/dns-records

Path parameters

domainstring required

The domain, e.g. 'acme.io'

Request body

namestring required

Record name. '@' for the root domain, a label like 'mail', or a full name. Root and www are reserved for domain forwarding.

contentstring required

Record value, e.g. an IP address, hostname, or TXT content

type'A' | 'AAAA' | 'CNAME' | 'MX' | 'TXT' | 'NS'

DNS record type

priorityinteger

Priority for MX records

Response

DNS record created

successboolean required

errorstring nullable