Run in Apidog
Updates an existing DNS record for a domain. Request Body# Field Type Required Description recordIdstringYes Unique identifier of the DNS record domainstringYes Domain name associated with the record hoststringYes Host name for the DNS record valuestringYes Value of the DNS record recordTypestringYes Type of DNS record (e.g., MX, A, CNAME) prioritystringNo Priority value (for MX records)
For DMARC TXT records, we auto generates the DMARC value using following default tags. By default, these tags are included: Tag Default Value Description ruamailto:<email>Aggregate report recipient email rufmailto:<email>Forensic/failure report recipient email fo0Failure reporting option rfafrfForensic report format ri604800Report interval in seconds pct100Percentage of messages the policy applies to sprejectSubdomain policy aspfrSPF alignment mode adkimrDKIM alignment mode
If you want to exclude specific optional tags, send them in: "excludedDMARCtags": ["rua", "ruf"] To remove already existing excluded DMARC tags, send excludedDMARCtags as an empty array Request Add parameter in header cmr-x-api-key
Example: cmr-x-api-key: ********************
or
Body Params application/json
{
"recordId" : "rec_98765" ,
"domain" : "example.com" ,
"host" : "mail" ,
"value" : "mail.example.com" ,
"recordType" : "MX" ,
"priority" : "10"
}
Request Code Samples
curl --location --request PUT 'https://customers.coldmailreseller.com/api/v1/integration/dns?userId=BVZGM5TE9BMP3PP0VWGW943RGV1K' \
--header 'cmr-x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
"recordId": "rec_98765",
"domain": "example.com",
"host": "mail",
"value": "mail.example.com",
"recordType": "MX",
"priority": "10"
}' Responses application/json
Generate Code
{
"status" : 200 ,
"message" : "DNS Record updated successfully" ,
"data" : {
"status" : "Success" ,
"statusDescription" : "The record was modified successfully."
} ,
"actionId" : "ACT_7a078272-0fa7-4db4-a85b-c78697dacea1"
}
Modified at 2026-06-23 16:21:02
