Wiki

Add record

Description

Add new record to domain zone.

Note: This function is available only for master zones. Works with reverse zones too.


 Parameters

Name Data Type Status Description
auth-id or sub-auth-id or sub-auth-user Integer  Required Authentication parameter
auth-password String  Required Authentication parameter
domain-name  String  Required  Domain name or reverse zone name you want to assign new record to
record-type  Integer  Required  A, AAAA, MX, CNAME, TXT, NS, SRV, WR, RP, SSHFP, ALIAS for domain names and NS and PTR for reversed zones
host  String  Required  host / subdomain
record  String  Required  Record you want to add. Example 10.10.10.10 or cname.cloudns.net
ttl  Integer  Required  Available TTL's:
60 = 1 minute
300 = 5 minutes
900 = 15 minutes
1800 = 30 minutes
3600 = 1 hour
21600 = 6 hours
43200 = 12 hours
86400 = 1 day
172800 = 2 days
259200 = 3 days
604800 = 1 week
1209600 = 2 weeks
2592000 = 1 month
priority  Integer Optional  Priority for MX or SRV record
weight  Integer Optional   Weight for SRV record
port  Integer  Optional   Port for SRV record
frame  Integer Optional   0 or 1 for Web redirects to disable or enable frame
frame-title  String  Optional   Tile if frame is enabled in Web redirects
frame-keywords  String Optional   Keywords if frame is enabled in Web redirects
frame-description  String  Optional   Description if frame is enabled in Web redirects
save-path  Integer  Optional   0 or 1 for Web redirects
redirect-type  Integer  Optional   301 or 302 for Web redirects if frame is disabled
mail  Integer  Optional   E-mail address for RP records
txt  Integer Optional   Domain name for TXT record used in RP records
algorithm  Integer  Optional   Algorithm used to create the SSHFP fingerprint. Required for SSHFP records only.
fptype  Integer   Optional  Type of the SSHFP algorithm. Required for SSHFP records only.
status  Integer   Optional  Set to 1 to create the record active or to 0 to create it inactive. If omitted the record will be created active.

Response: Array with status and status description.


Example

URL JSON: https://api.cloudns.net/dns/add-record.json
Domain POST/GET:
auth-id=0&auth-password=password&domain-name=domain.com&record-type=A&host=www&record=10.10.10.10&ttl=3600
sub-auth-id=0&auth-password=password&domain-name=domain.com&record-type=A&host=www&record=10.10.10.10&ttl=3600
Reverse IPv4 POST/GET:
auth-id=0&auth-password=password&domain-name=1.0.0.127.in-addr.arpa&record-type=PTR&host=@&record=domain.com&ttl=3600
sub-auth-id=0&auth-password=password&domain-name=1.0.0.127.in-addr.arpa&record-type=PTR&host=@&record=domain.com&ttl=3600
Reverse IPv6 POST/GET:
auth-id=0&auth-password=password&domain-name=1.2.3.4.5.6.7.8.9.0.1.2.3.4.5.6.7.8.9.0.1.2.3.4.5.6.7.8.9.0.1.2.ip6.arpa&record-type=PTR&host=@&record=domain.com&ttl=3600
sub-auth-id=0&auth-password=password&domain-name=1.2.3.4.5.6.7.8.9.0.1.2.3.4.5.6.7.8.9.0.1.2.3.4.5.6.7.8.9.0.1.2.ip6.arpa&record-type=PTR&host=@&record=domain.com&ttl=3600

URL XML: https://api.cloudns.net/dns/add-record.xml
Domain POST/GET:
auth-id=0&auth-password=password&domain-name=domain.com&record-type=A&host=www&record=10.10.10.10&ttl=3600
sub-auth-id=0&auth-password=password&domain-name=domain.com&record-type=A&host=www&record=10.10.10.10&ttl=3600
Reverse IPv4 POST/GET:
auth-id=0&auth-password=password&domain-name=1.0.0.127.in-addr.arpa&record-type=PTR&host=@&record=domain.com&ttl=3600
sub-auth-id=0&auth-password=password&domain-name=1.0.0.127.in-addr.arpa&record-type=PTR&host=@&record=domain.com&ttl=3600
Reverse IPv6 POST/GET:
auth-id=0&auth-password=password&domain-name=1.2.3.4.5.6.7.8.9.0.1.2.3.4.5.6.7.8.9.0.1.2.3.4.5.6.7.8.9.0.1.2.ip6.arpa&record-type=PTR&host=@&record=domain.com&ttl=3600
sub-auth-id=0&auth-password=password&domain-name=1.2.3.4.5.6.7.8.9.0.1.2.3.4.5.6.7.8.9.0.1.2.3.4.5.6.7.8.9.0.1.2.ip6.arpa&record-type=PTR&host=@&record=domain.com&ttl=3600

Cookies help us deliver our services. By using our services, you agree to our use of cookies. Learn more