Skip to main content
POST
/
core
/
v1
/
domains
/
{domainName}
/
records
Create Record
curl --request POST \
  --url https://api.dev.name.com/core/v1/domains/{domainName}/records \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '{
  "answer": "<string>",
  "fqdn": "<string>",
  "host": "<string>",
  "id": 123,
  "priority": 123,
  "ttl": 123,
  "type": "A"
}'
{
  "answer": "<string>",
  "domainName": "<string>",
  "fqdn": "<string>",
  "host": "<string>",
  "id": 123,
  "priority": 123,
  "ttl": 123,
  "type": "<string>"
}

Authorizations

​
Authorization
string
header
required

Authenticate via HTTP Basic with your account username and API token. Examples use an explicit 'Authorization: Basic <base64(username:token)>' header; 'curl -u username:token' is equivalent. For sandbox, append "-test" to your username and use your sandbox token on api.dev.name.com.

Path Parameters

​
domainName
string
required

DomainName is the zone that the record belongs to.

Body

application/json

Record is an individual DNS resource record.

​
answer
string
required

Answer is either the IP address for A or AAAA records; the target for ANAME, CNAME, MX, or NS records; the text for TXT records. For SRV records, answer has the following format: "{weight} {port} {target}" e.g. "1 5061 sip.example.org".

Minimum length: 1
​
host
string
required

Host is the hostname relative to the zone: e.g. for a record for blog.example.org, domain would be "example.org" and host would be "blog". An apex record would be specified by either an empty host "" or "@". A SRV record would be specified by "{service}.{protocol}.{host}": e.g. "_sip._tcp.phone" for _sip._tcp.phone.example.org.

​
type
enum<string>
required

Type is one of the following: A, AAAA, ANAME, CNAME, MX, NS, SRV, or TXT.

Available options:
A,
AAAA,
ANAME,
CNAME,
MX,
NS,
SRV,
TXT
​
fqdn
string

FQDN is the Fully Qualified Domain Name. It is the combination of the host and the domain name. It always ends in a ".". FQDN is ignored in CreateRecord, specify via the Host field instead.

​
id
integer

Unique record id. Value is ignored on Create, and must match the URI on Update.

​
priority
integer

Priority is only required for MX and SRV records, it is ignored for all others.

​
ttl
integer

TTL is the time this record can be cached for in seconds. name.com allows a minimum TTL of 300, or 5 minutes.

Response

A successful response.

Record is an individual DNS resource record.

​
ttl
integer
required

TTL is the time this record can be cached for in seconds. name.com allows a minimum TTL of 300, or 5 minutes.

​
type
string | null
required

Type is one of the following: A, AAAA, ANAME, CNAME, MX, NS, SRV, or TXT.

​
answer
string

Answer is either the IP address for A or AAAA records; the target for ANAME, CNAME, MX, or NS records; the text for TXT records. For SRV records, answer has the following format: "{weight} {port} {target}" e.g. "1 5061 sip.example.org".

​
domainName
string

DomainName is the zone that the record belongs to.

​
fqdn
string

FQDN is the Fully Qualified Domain Name. It is the combination of the host and the domain name. It always ends in a ".". FQDN is ignored in CreateRecord, specify via the Host field instead.

​
host
string | null

Host is the hostname relative to the zone: e.g. for a record for blog.example.org, domain would be "example.org" and host would be "blog". An apex record would be specified by either an empty host "" or "@". A SRV record would be specified by "{service}.{protocol}.{host}": e.g. "_sip._tcp.phone" for _sip._tcp.phone.example.org.

​
id
integer

Unique record id. Value is ignored on Create, and must match the URI on Update.

​
priority
integer

Priority is only required for MX and SRV records, it is ignored for all others.

⌘I