Help Center
Login Sign up
  1. Home
  2. API reference
  3. API documentation (JSON/XML)
  4. Tasks
  5. Zone tasks

Zone create

API reference (XML/JSON) · Updated 2023-09-19

Function

The ZoneCreate task creates a new zone on the name servers managed by the system.

Description

Route: POST/zone

{
   "origin": "example.com",
   "soa": {
      "refresh": 3600,
      "retry": 7200,
      "expire": 604800,
      "ttl": 600,
      "email": "customer@example.com"
   },
   "dnssec": false,
   "allowTransfer": false,
   "nameServers": [
      {
         "name": "ns1.example.com",
         "ttl": 600,
         "ipAddresses": [
            "1.2.3.4"
         ]
      },
      {
         "name": "ns2.example.com",
         "ttl": 600,
         "ipAddresses": [
            "4.3.2.1"
         ]
      }
   ],
   "main": {
      "address": "7.7.7.7",
      "ttl": 86000
   },
   "wwwInclude": true,
   "action": "COMPLETE",
   "resourceRecords": [
      {
         "name": "subdomainexample",
         "ttl": 600,
         "type": "A",
         "value": "1.3.5.7"
      }
   ]
}
{
   "stid": "20190701-app2-dev-15785",
   "status": {
      "code": "S0205",
      "text": "Zone information was inquired successfully.",
      "type": "SUCCESS"
   },
   "object": {
      "type": "Zone",
      "summary": 3
   },
   "data": [
      {
         "created": "2014-10-24T09:42:57.000+0200",
         "updated": "2017-11-17T17:35:40.000+0100",
         "origin": "example.com",
         "owner": {
            "context": 4,
            "user": "customer"
         },
         "updater": {
            "context": 1,
            "user": "customer"
         },
         "virtualNameServer": "ns1.nameserver.com"
      },
      {
         "created": "2019-05-13T11:26:36.000+0200",
         "updated": "2019-05-13T13:51:20.000+0200",
         "origin": "example2.org",
         "dnssec": false,
         "owner": {
            "context": 4,
            "user": "customer"
         },
         "updater": {
            "context": 4,
            "user": "customer"
         },
         "virtualNameServer": "ns2.nameserver.com"
      },
      {
         "created": "2019-05-13T11:26:36.000+0200",
         "updated": "2019-05-17T13:33:02.000+0200",
         "origin": "example3.com",
         "dnssec": false,
         "owner": {
            "context": 4,
            "user": "customer"
         },
         "updater": {
            "context": 4,
            "user": "customer"
         },
         "virtualNameServer": "ns3.nameserver.com"
      }
   ]
}