Need help? Call Live Support at +31 (0) 38 453 07 59

Create DNS zone

Used to create an unmanaged DNS zone, only one zone can exist per service. If a zone exists for the specified service that is pending deletion, the existing zone is removed immediately in order to allow the creation of the new zone.

  • POSTMethod
  • /v2/dns/zonesURL
  • application/jsonContent-Type
Request content fields
Name Type Required / Optional Description Restrictions
name String Required The zone (domain) name
  • Regular expression: ^(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\.)+(?:[a-z][a-z0-9-]{0,61}[a-z0-9])$
  • Minimum length: 3
  • Maximum length: 255
  • Registry specific restrictions may apply
service Enum Optional DNS service to provision, defaults to BASIC

Possible values:

  • BASIC: Basic, free DNS
  • PREMIUM: Premium DNS
template String Optional Name of the template to use
link Boolean Optional Unless false, the zone is linked to the template
master String Optional IP address of the (hidden) master
ns List <String> Optional List of name servers for the DNS zone
  • Regular expression: ^(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\.)+(?:[a-z][a-z0-9-]{0,61}[a-z0-9])$
  • Maximum number of items: 10
  • Minimum length: 4
  • Maximum length: 255
dnssec Boolean Optional Provision zone with DNSSEC
hostMaster String Optional The email address of the hostmaster
refresh Integer Optional The time when the slave will try to refresh the zone from the master, in seconds
retry Integer Optional The time between retries if the slave (secondary) fails to contact the master when refresh has expired, in seconds
  • Default Value: 3600
  • Minimum value: 1
expire Integer Optional Indicates when the zone data is no longer authoritative, in seconds
  • Default Value: 1209600
  • Maximum value: 4838400
  • Minimum value: 86400
ttl Integer Optional The duration that the record may be cached, in seconds
  • Default Value: 3600
  • Maximum value: 2419200
  • Minimum value: 60
records List < records > Optional DNS records
records
Name Type Required / Optional Description Restrictions
name String Required The full record name.
type Enum Required The record type

Possible values:

  • A: Address record
  • MX: Mail exchange record
  • CNAME: Canonical name record
  • AAAA: IPv6 address record
  • URL: URL Record
  • MBOXFW: Mailbox forward record
  • HINFO: Host information record
  • NAPTR: Naming Authority Pointer
  • NS: Name server record
  • SRV: Service locator
  • CAA: Certification Authority Authorization
  • TLSA: Transport Layer Security Authentication
  • ALIAS: ALIAS record
  • TXT: Text record
  • SOA: Start of [a zone of] authority record
  • DNSKEY: DNSKEY record
  • CERT: Certificate record
  • DS: DS record
  • LOC: Location record
  • SSHFP: SSH key record
  • URI: URI record
content String Required Type specific content of the record
ttl Integer Optional The duration that the record may be cached, in seconds (if not set, the default ttl of template (the ttl key in the request body) is used)
prio Integer Optional The priority, mandatory if "type" is MX or SRV

Successful request

DNS template has been created successfully
  • 201 CreatedHTTP Status
  • application/jsonContent-Type
Response fields
Name Type Required / Optional Description
id Integer Required

Failed requests

Besides the generic errors these specific error responses can be expected.

Error responses
Type Status Description
DnsConfigurationException 400 Bad Request The DNS records contain errors
Request parameters
The zone (domain) name
DNS service to provision, defaults to BASIC
Name of the template to use
Unless false, the zone is linked to the template
IP address of the (hidden) master
List of name servers for the DNS zone
Provision zone with DNSSEC
The email address of the hostmaster
The time when the slave will try to refresh the zone from the master, in seconds
The time between retries if the slave (secondary) fails to contact the master when refresh has expired, in seconds
Indicates when the zone data is no longer authoritative, in seconds
The duration that the record may be cached, in seconds
records
The full record name.
The record type
Type specific content of the record
The duration that the record may be cached, in seconds (if not set, the default ttl of template (the ttl key in the request body) is used)
The priority, mandatory if "type" is MX or SRV
Request

POST /v2/dns/zones
Content-Type: application/json 

{}
Response