Add Record

Add a Record to an Existing Domain for Hosted DNS

Add Record URL:

POSThttps://api.hyperleaf.com/api/dns/add_record

POST Examples

A Record

curl https://api.hyperleaf.com/api/dns/add_record?key=mykey \
    -d 'domain=blah.com' \
    -d 'type=A' \
    -d 'host=api' \
    -d 'record=4.3.4.3'

MX Record

CNAM Record

TXT Record

Request Fields (* required)

Name	Type	Description
domain*	string	the domain you're adding a record to
type*	string	Record Type: A, AAA, NS, MX, TXT, CNAM, etc. (full list below)
host	string	host you're adding (ex: if you're adding api.example.com, host would be just: host=api, set host to @ or omit if using root (@) host, example just: example.com
record*	string	the point to record, for example: domain=example.com&host=api&record=3.4.3.4
ttl	int	time to live in seconds, how long until DNS record should be looked up again, specific supported list below ttl default: 3600 (1hour)
priority	int	priority for record types like MX and SVR (0-65535)
weight	int	weight for record types like MX and SVR (0-65535)
port	int	port for record types like SVR (0-65535)

Response Examples

Success

{
    "status": "ok",
    "message": "record added"
}

Failure

DNS record types supported:

A, AAAA, ALIAS, CAA, CERT, CNAME, DNAME, DS, HINFO, LOC, MX, NAPTR, NS, OPENPGPKEY, PTR, RP, SMIMEA, SPF, SRV, SSHFP, TLSA, TXT

As JSON:

{"A":"A","AAAA":"AAAA","ALIAS":"ALIAS","CAA":"CAA","CERT":"CERT","CNAME":"CNAME","DNAME":"DNAME","DS":"DS","HINFO":"HINFO","LOC":"LOC","MX":"MX","NAPTR":"NAPTR","NS":"NS","OPENPGPKEY":"OPENPGPKEY","PTR":"PTR","RP":"RP","SMIMEA":"SMIMEA","SPF":"SPF","SRV":"SRV","SSHFP":"SSHFP","TLSA":"TLSA","TXT":"TXT"}

TTL numbers supported:

60, 300, 600, 900, 1800, 3600, 21600, 43200, 86400, 172800, 259200, 604800, 1209600, 2592000

As JSON:

{"ttl":[{"value":"60","text":"1 Minute"},{"value":"300","text":"5 Minutes"},{"value":"600","text":"10 Minutes"},{"value":"900","text":"15 Minutes"},{"value":"1800","text":"30 Minutes"},{"value":"3600","text":"1 Hour"},{"value":"21600","text":"6 Hours"},{"value":"43200","text":"12 Hours"},{"value":"86400","text":"1 Day"},{"value":"172800","text":"2 Days"},{"value":"259200","text":"3 Days"},{"value":"604800","text":"1 Week"},{"value":"1209600","text":"2 Weeks"},{"value":"2592000","text":"1 month"}]}