---
title: "Create a new name"
method: POST
path: "/v1/dns/records/{zone_name}"
tags: ["records"]
---

# Create a new name

`POST /v1/dns/records/{zone_name}`

Create a new name, with records and metadata.

## Path parameters

- `zone_name` string, required — The name of the zone.

## Request body

- NewDnsName — A new name to be created.
  - `name` string, required — The DNS name, not including the zone portion.
  - `rrsets` NewRRSet[] — List of RRSets to create with the name
    - `dns_type` 'A' | 'AAAA' | 'CAA' | 'CNAME' | 'MX' | 'NS' | 'SRV' | 'TXT' | 'PTR' | '_URL' | 'ALIAS', required — DNS name type supported by API
    - `rdata` NewRdata[] — List of Rdata for this RRset
      - `value` string, required — Rdata value
      - `label` string — Label for an Rdata that uniquely identifies it within its RRSet Labels are case-insensitive and may contain alphanumeric characters and dashes. If a label is not set manually, it will be autogenerated, prefixed with an underscore _.
    - `ttl` integer, nullable — Time to live (seconds)
    - `metadata` Metadata — A collection of string key/value pairs that provide additional information or classification for an object.
  - `offline_settings` OfflineSettings
    - `action` 'no_action' | 'ip' | 'web_redirect' | 'page', required
    - `ip` string, nullable — Ip address used when action is `ip`
    - `web_redirect` string, nullable — Url to redirect used when action is `url`
    - `page_title` string, nullable — Page title when action is `page`
    - `page_text` string, nullable — Page text when action is `page`
    - `page_email` string, nullable — Page contact email when action is `page`
    - `page_logo_url` string, nullable — Page logo when action is `page`
  - `is_offline` boolean, nullable — Is the DNS name offline?
  - `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: - DNS hostname contains too many labels (code: 2324) - Rdata labels must be unique in an RRset (code: 2008) - a label contains characters not in the allowed character set (code: 3284) - a wildcard label must be the terminal label in a name (code: 3893) - duplicated update groups for rrset (code: 4344) - expected valid offline settings for offline name (code: 2212) - invalid ALIAS record (code: 4159) - invalid CNAME record (code: 4659) - invalid DNS update group (code: 3315) - invalid NS record (code: 3111) - invalid PTR record (code: 4619) - invalid Rdata label (code: 4819) - invalid TTL (code: 3295) - invalid email address (code: 3588) - invalid format for Rdata (code: 2839) - invalid format for URL redirect (code: 3564) - invalid logo url (code: 3562) - invalid name (code: 3607) - invalid offline IP address (code: 2711) - invalid redirect URL (code: 2788) - label is required for rdata update group targets (code: 4945) - operation violates DNS rules (code: 3363) - required field missing for offline action (code: 2714) - the parent of a wildcard cannot be an empty nonterminal node (code: 3624) - unsupported DNS record type (code: 3252) - update group target dns type must be either A, AAAA or _URL (code: 3325) - update group target on both name and rdata (code: 3731)
- `401` — unauthorized (code: 2465)
- `402` — Multiple error variants are possible: - DNS names are over limit; please contact support (code: 3354) - RRset metadata over limit; please contact support (code: 4556) - Rdata count is over limit; please contact support (code: 4428) - dns name metadata over limit; please contact support (code: 2218)
- `403` — Multiple error variants are possible: - DNS types disallowed (code: 2051) - RRset TTL cannot be changed (code: 4535) - changing this zone is prohibited; please contact support (code: 3903) - creating a DNS name in this zone is forbidden (code: 3331) - new names cannot be created in this zone (code: 2784) - not allowed (code: 4748) - only auto-generated Rdata labels may start with an underscore (code: 4555) - only the zone owner may create this record (code: 4365) - operation only available via the website (code: 4786) - requested RRset TTL is too low (code: 3655) - updating this DNS update group is forbidden (code: 4127) - wildcards in labels are restricted (code: 4072)
- `404` — Multiple error variants are possible: - zone not found (code: 2510) - zone not shared (code: 2728)
- `409` — Multiple error variants are possible: - DNS name already exists (code: 4285) - DNS name is already owned (code: 3424) - Rdata value already exists (code: 2722) - conflicting target already exists in a group (code: 3311) - target already exists (code: 3676)
- `422` — alias points to name outside the zone (code: 4145)

---

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