---
title: "Create a zone"
method: POST
path: "/v1/dns/zones"
tags: ["zones"]
---

# Create a zone

`POST /v1/dns/zones`

Create a zone and request its publication.
When the zone gets published, it becomes resolvable on the primary nameservers.

## Request body

- NewZone — New DNS zone to create.
  - `name` string, required — The name of the zone.
  - `request_publication` boolean, nullable — Zone is to published (resolvable on Internet) upon creation
  - `serial_epoch` integer, nullable — Initial serial number to use in published zone data (default: 1)
  - `zone_authority` string — ## Identifier A string type that has a limited character set, which makes it useful as an easy to type identifier for use in things like URL paths. The restrictions are alphanumeric characters (Unicode is permitted), plus dashes and underscore except for the initial character.
  - `nx_ttl` integer, nullable
  - `metadata` Metadata — A collection of string key/value pairs that provide additional information or classification for an object.

## Response `201`

resource created

- CommandSuccess
  - `warnings` Warning[]
    - `code` string, required — A code for this warning.
    - `title` string, required — A title for this warning.
    - `detail` string, nullable — Contextual information about this warning.

## Other responses

- `400` — Multiple error variants are possible: - invalid identifier (code: 3913) - invalid zone name (code: 4637)
- `401` — unauthorized (code: 2465)
- `402` — Multiple error variants are possible: - owned zones are over limit; please contact support (code: 4085) - zone metadata over limit; please contact support (code: 4228)
- `403` — Multiple error variants are possible: - not allowed (code: 4748) - operation only available via the website (code: 4786)
- `404` — Multiple error variants are possible: - zone authority not found (code: 3792) - zone primary not found (code: 3124)
- `409` — Multiple error variants are possible: - zone already exists (code: 3901) - zone containing this name already exists. (code: 3728) - zone is within an existing zone (code: 4032)

---

[API](https://skmtc.net/noip/apis/no-ip-api.md) · [All operations](https://skmtc.net/noip/apis/no-ip-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/noip/no-ip-api/revisions/619d78b2a70e/schema)