Create Dynamic DNS credential

POST

/domains/{domain}/dns/dynamic

Create a Dynamic DNS credential for one hostname of the domain. The password is in this response only; store it, because it cannot be shown again (reset it if it is lost). Not available for domains whose DNS is managed through Cloudflare.

Request

Authorization

Add parameter in header

API-Key

Example:

API-Key: ********************

Path Params

Header Params

Body Params application/json

Example

{
    "hostname": "home",
    "label": "Router at home",
    "allow_ipv4": true,
    "allow_ipv6": true
}

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/dynamic' \
--header 'Accept: application/json' \
--header 'User-Agent: my-application/1.0.0' \
--header 'API-Key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "hostname": "home",
    "label": "Router at home",
    "allow_ipv4": true,
    "allow_ipv6": true
}'

Responses

🟢200OK

application/json

Bodyapplication/json

Example

{
    "status": 200,
    "status_description": "Dynamic DNS credential created",
    "data": {
        "id": 12,
        "label": "Router at home",
        "hostname": "home",
        "fqdn": "home.domain.com",
        "username": "ddns_a1b2c3d4e5f6",
        "password": "q8Vx2LmB0rTnKp4ZyW7cHd1e",
        "allow_ipv4": true,
        "allow_ipv6": true,
        "force_wildcard": false,
        "active": true,
        "last_ipv4": null,
        "last_ipv6": null,
        "last_update_at": null,
        "last_status": null,
        "created_at": "2026-11-10T09:43:00+01:00",
        "update_url": "https://ddns_a1b2c3d4e5f6:q8Vx2LmB0rTnKp4ZyW7cHd1e@mijn.host/nic/update?hostname=home.domain.com&myip=&myipv6="
    }
}

🟠400Invalid hostname

🟠400Allow IPv4, IPv6 or both

🟠400Dynamic DNS is not available for domains whose DNS is managed through Cloudflare

🟠400Invalid input

🟠400SSL connection is required

🟠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

List Dynamic DNS credentials

Delete Dynamic DNS credential