Add single DNS record

POST

/domains/{domain}/dns

Add one value to a record set (records with the same name and type), next to the values it already has; a set that does not exist yet is created. Use this to add, for example, a TXT record for a verification without touching the SPF record on the same name. Adding a value that is already there changes nothing ("DNS record already exists"). A CNAME can have only one value. Other record sets are never touched.

Request

Authorization

API Key

Add parameter in header

API-key

Example:

API-key: ********************

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Header Params

Body Params application/json

Example

{
    "record": {
        "type": "TXT",
        "name": "domain.com.",
        "value": "google-site-verification=abc123"
    }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://mijn.host/api/v2/domains/domain.com/dns' \
--header 'Accept: application/json' \
--header 'User-Agent: my-application/1.0.0' \
--header 'API-key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "record": {
        "type": "TXT",
        "name": "domain.com.",
        "value": "google-site-verification=abc123"
    }
}'

Responses

🟢200OK

application/json

Bodyapplication/json

Example

{
    "status": 0,
    "status_description": "string"
}

🟠400Wrong request method

🟠400SSL connection is required

🟠400No record provided. Use the 'record' object to pass a DNS record.

🟠400TTL is too high, maximum is 2147483647

🟠400No domain set

🟠400You have no access to this resource

🟠401No valid API key set

🟠401API key has expired

🟠401Remote IP address is not found in the API key whitelist

🔴500Error

Modified at 2026-11-13 09:40:27

Delete single DNS record

Get DNS history