Add new record to domain zone.
Note: This function is available only for master zones. Works with reverse zones too.
| 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 | String | Required | A, AAAA, MX, CNAME, TXT, NS, SRV, WR, RP, SSHFP, ALIAS, CAA 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 | Title 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 |
| 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. |
| geodns-location | Integer | Optional | ID of a GeoDNS location for A, AAAA or CNAME record. The GeoDNS locations can be obtained with List GeoDNS locations |
| caa_flag | Integer | Optional | 0 - Non critical or 128 - Critical |
| caa_type | String | Optional | Type of CAA record. The available flags are issue, issuewild, iodef. |
| caa_value | String | Optional | If caa_type is issue, caa_value can be hostname or ";". If caa_type is issuewild, it can be hostname or ";". If caa_type is iodef, it can be "mailto:someemail@address.tld, http://example.tld or http://example.tld. |
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