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

# Create a zone authority

`POST /v1/dns/zone-authorities`

Create an authority for use in zones.

## Request body

- ZoneAuthority
  - `name` string, required — ## 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.
  - `mname` string, nullable
  - `rname` string, nullable
  - `nameservers` string[], nullable
  - `extend` boolean, nullable

## 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: - at least one of mname, rname or nameservers must be specified (code: 2708) - invalid fqdn (code: 4931) - nameservers must be non-empty if extend is false (code: 2358)
- `401` — unauthorized (code: 2465)
- `403` — no more zone authorities may be created (code: 4620)
- `409` — zone authority already exists (code: 4576)

---

[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)