Skip to content
The No-IP API is in beta and we are actively working on new features and endpoints.

Create a new name

POST /v1/dns/records/{zone_name}

Create a new name, with records and metadata.

Path Parameters

zone_name

The name of the zone.

Example: example.com

Body

application/json

Body Sample

{
"metadata": {
"public property": "public value"
},
"name": "dns-name",
"rrsets": [
{
"dns_type": "A",
"metadata": {
"key": "value"
},
"rdata": [
{
"label": "optional-label-1",
"update_group": "grp1",
"value": "192.0.2.1"
},
{
"value": "192.0.2.2"
}
],
"ttl": 60
},
{
"dns_type": "AAAA",
"rdata": [
{
"label": "optional-label-2",
"update_group": "grp2",
"value": "2001:db8::1"
}
],
"ttl": 60
}
],
"update_group": "grp_1-2"
}

Body Description

metadata object

A collection of string key/value pairs that provide additional information or classification for an object.

* name string

The DNS name, not including the zone portion.

Example: dns-name

rrsets array[object]

[RRSet to create.]

* dns_type string enum

DNS name type supported by API

Example: A

Possible Values
A
AAAA
CAA
CNAME
MX
NS
SRV
TXT
PTR
_URL
rdata array[object]

List of Rdata for this RRset

label string

Label for an Rdata that uniquely identifies it within its RRSet

Example: a-label-123

update_group string

Name of the update group

Example: grp_1-2

* value string

Rdata value

Example: 192.0.2.1

ttl integer

Example: 60

Minimum: 0

update_group string

Name of the update group

Example: grp_1-2

Response