Create DNS record
create_dns_recordCreates a new DNS record for a domain and returns the stored record with its new ID, enabling DNS configuration changes such as adding A, CNAME, MX, or TXT entries.
Instructions
Create a new DNS record for a domain. Returns the stored record, including its new ID.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"domain_id": "<domain_id>",
"host": "<host>",
"type": "<type>",
"data": "<data>"
},
"name": "create_dns_record"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| alg | No | required for DS: the DNSSEC signing algorithm number, 0-255 | |
| tag | No | required for DS as a number (the key tag 0-65535 of the referenced DNSKEY) and for CAA as a string (the property tag, e.g. issue, issuewild or iodef) | |
| ttl | No | time-to-live in seconds, 60-604800, must be a multiple of 60, defaults to 3600 | |
| data | Yes | the record's main value: an IPv4 address for A, an IPv6 address for AAAA, a hostname for ANAME/CNAME/MX/NS/SRV, free text for TXT, the CAA property value, or the hex hash for DS/TLSA | |
| host | Yes | the host/subdomain the record applies to, e.g. 'www' or '@' for the root | |
| port | No | required for SRV: the port 0-65535 the service is found on | |
| type | Yes | the record type | |
| dtype | No | required for TLSA: matching type of the hash in data (0 exact match, 1 SHA-256, 2 SHA-512) | |
| flags | No | required for CAA: 128 to mark the property critical, otherwise 0 | |
| usage | No | required for TLSA: certificate usage (0 PKIX-TA, 1 PKIX-EE, 2 DANE-TA, 3 DANE-EE) | |
| digest | No | required for DS: digest type of the hash in data (1 SHA-1, 2 SHA-256, 4 SHA-384) | |
| weight | No | required for SRV: relative weight 0-65535 among records with the same priority | |
| priority | No | required for MX and SRV: preference value 0-65535, lower is tried first | |
| selector | No | required for TLSA: what the hash is taken from (0 full certificate, 1 subject public key) | |
| domain_id | Yes | the Domeneshop domain ID, from list_domains |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | ||
| alg | No | ||
| tag | No | ||
| ttl | No | ||
| data | Yes | ||
| host | Yes | ||
| port | No | ||
| type | Yes | ||
| dtype | No | ||
| flags | No | ||
| usage | No | ||
| digest | No | ||
| weight | No | ||
| priority | No | ||
| selector | No |