Adds dns record

POST

/dns

Adds new DNS records for a domain.

Request Body

Field	Type	Required	Description
`domain`	`string`	Yes	Domain name to add DNS records for
`records`	`array`	Yes	Array of DNS record objects to be added

Record Object

Field	Type	Required	Description
`host`	`string`	Yes	Host name for the DNS record
`value`	`string`	Yes	Value of the DNS record
`recordType`	`string`	Yes	Type of DNS record (e.g., `MX`, `TXT`)

Request

Authorization

API Key

Add parameter in header

cmr-x-api-key

Example:

cmr-x-api-key: ********************

Query Params

Body Params application/json

Example

{
  "domain": "example.com",
  "records": [
    {
      "host": "mail",
      "value": "mail.example.com",
      "recordType": "MX"
    },
    {
      "host": "_acme-challenge",
      "value": "randomChallengeString",
      "recordType": "TXT"
    }
  ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://customers.coldmailreseller.com/api/v1/integration/dns?userId=BVZGM5TE9BMP3PP0VWGW943RGV1K' \
--header 'cmr-x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
  "domain": "example.com",
  "records": [
    {
      "host": "mail",
      "value": "mail.example.com",
      "recordType": "MX"
    },
    {
      "host": "_acme-challenge",
      "value": "randomChallengeString",
      "recordType": "TXT"
    }
  ]
}'

Responses

🟢200Success

application/json

Body

Example

{
    "status": 200,
    "message": "DNS Records added successfully!",
    "data": null
}

🟠422Unprocessable Entity

Modified at 2025-10-29 17:06:38

Get dns records for a domain

Update dns records