Import DNS zonefile

PUT

/domains/{domain}/dns/zone

Replace all DNS records of a specific domain with the contents of a BIND style zonefile. Every record currently in the zone is removed, so the zonefile must contain the complete desired state. Send JSON { "zone": "<zonefile>" } with Content-Type: application/json. Encode the request body as JSON so the zonefile's newlines and tabs become \n and \t inside that string; a JSON library does this automatically — do not send the zonefile as the raw HTTP body and do not encode the zonefile twice. Lines are read as name ttl IN type rdata; blank lines, comments, directives such as $TTL and lines that do not have all five fields are ignored. SOA and apex NS records in the body are ignored: the apex NS records of the existing zone are kept. When the zonefile is rejected, the previous records are restored. Not available for domains whose DNS is managed through Cloudflare.

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

{
    "zone": "domain.com.\t900\tIN\tA\t135.226.123.12\nwww.domain.com.\t900\tIN\tCNAME\tdomain.com.\ndomain.com.\t900\tIN\tMX\t10 mail.domain.com.\ndomain.com.\t900\tIN\tTXT\t\"v=spf1 include:spf.my.host ~all\"\n"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request PUT 'https://mijn.host/api/v2/domains/domain.com/dns/zone' \
--header 'Accept: application/json' \
--header 'User-Agent: my-application/1.0.0' \
--header 'API-key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "zone": "domain.com.\t900\tIN\tA\t135.226.123.12\nwww.domain.com.\t900\tIN\tCNAME\tdomain.com.\ndomain.com.\t900\tIN\tMX\t10 mail.domain.com.\ndomain.com.\t900\tIN\tTXT\t\"v=spf1 include:spf.my.host ~all\"\n"
}'

Responses

🟢200OK

application/json

Bodyapplication/json

Example

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

🟠400No zone provided. Use the "zone" string to pass a zonefile.

🟠400Zone import is not available for Cloudflare-managed domains.

🟠400Wrong request method

🟠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

Get DNS zonefile

List Dynamic DNS credentials