Convert a domain between receiving and send-only
Switch an existing domain between email (receives, publishes an MX) and email-send (sends only, never receives) without re-adding it. Only that pair converts — a webhook domain publishes a CNAME, which cannot coexist with an MX (RFC 1034/2181), so it is refused with 422.
Converting to email-send is refused with 409 while any alias still receives on the domain: those addresses would keep looking live while receiving nothing. Delete them first. Converting to email publishes an MX, which redirects the domain's mail, so the same acknowledge_mx_conflict gate as create applies — and the domain returns to pending-dns until that MX resolves.
Ownership TXT, DKIM CNAMEs and any MAIL FROM records are untouched either way, so nothing already published needs republishing, and a domain already enabled for sending keeps sending across the conversion.
Authorizations
Scoped API key. Scopes are read ⊂ write ⊂ admin. A call needing more scope than the key holds returns 403 insufficient_scope.
Parameters
Path Parameters
Request Body
Responses
The converted domain and the record set to publish.