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 undefined
* name string

The DNS name, not including the zone portion.

Example: "dns-name"

rrsets array[object]

[RRSet to create.]

Example: [{"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}]

metadata undefined
* 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

Example: [{"label":"optional-label-1","update_group":"grp1","value":"192.0.2.1"},{"value":"192.0.2.1"}]

label undefined
update_group undefined
* value string

Rdata value

Example: "192.0.2.1"

ttl integer,null

Example: 60

Minimum: 0

update_group string

Name of the update group

Example: "grp_1-2"

Response