---
title: "Create Zone"
method: POST
path: "/dns/v2/zones"
tags: ["Zones"]
---

# Create Zone

`POST /dns/v2/zones`

Add DNS zone.

## Request body

- InputZone
  - `contact` string — email address of the administrator responsible for this zone
  - `enabled` boolean — If a zone is disabled, then its records will not be resolved on dns servers
  - `expiry` integer — number of seconds after which secondary name servers should stop answering request for this zone
  - `meta` object — arbitrarily data of zone in json format you can specify `webhook` url and `webhook_method` here webhook will get a map with three arrays: for created, updated and deleted rrsets `webhook_method` can be omitted, POST will be used by default
  - `name` string, required — name of DNS zone
  - `nx_ttl` integer — Time To Live of cache
  - `primary_server` string — primary master name server for zone
  - `refresh` integer — number of seconds after which secondary name servers should query the master for the SOA record, to detect zone changes.
  - `retry` integer — number of seconds after which secondary name servers should retry to request the serial number
  - `serial` integer — Serial number for this zone or Timestamp of zone modification moment. If a secondary name server slaved to this one observes an increase in this number, the slave will assume that the zone has been updated and initiate a zone transfer.

## Response `200`

CreateZoneResponse

- CreateZoneResponse
  - `id` integer
  - `warnings` string[]

## Other responses

- `400` — Error message response

---

[API](https://skmtc.net/g-core/apis/gcore-openapi.md) · [All operations](https://skmtc.net/g-core/apis/gcore-openapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/g-core/gcore-openapi/revisions/09e652815095/schema)