Vee3

Add DNS host

Add one Namecheap DNS host record for a domain managed through this Vee3 account.

← All Domains endpoints · Capability overview

POST/v1/domains/managed/{domain}/dns-hosts

https://api.vee3.io/v1/domains/managed/{domain}/dns-hosts

5 tokens

Add one Namecheap DNS host record for a domain managed through this Vee3 account.

Authorization

Send your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

MCP

The same capability is available as an MCP tool on Vee3 hosted MCP.

Tool name

domains.add_dns_host
Parameters6 fields
domainstringRequired

Managed domain name (for example example.com).

host_namestringRequired

Host label to create, for example @, www, or mail.

record_typestringRequired

DNS record type. Supported values: A, AAAA, ALIAS, CAA, CNAME, MX, MXE, NS, TXT, URL, URL301, FRAME.

addressstringRequired

Record value (IP, hostname, URL, or TXT content depending on type).

ttlintegerOptional

TTL in seconds (60 to 60000). Defaults to 1800.

Default: 1800 · min 60, max 60000

mx_prefintegerOptional

MX preference. Required when record_type is MX or MXE.

min 0, max 65535

Response9 fields
domainstring

Managed domain name.

is_using_namecheap_dnsboolean

Whether the domain currently uses Namecheap DNS.

hostsarrayitems
6 fields

Full DNS host list after the addition.

host_idstring

Namecheap host record id.

host_namestring

Host label, for example @ or www.

record_typestring

DNS record type.

addressstring

Record value.

mx_prefstring

MX preference when record_type is MX or MXE.

ttlinteger

TTL in seconds.

HTTP errors: unauthorized, validation_error, insufficient_tokens, payment_required, domains_not_configured, domains_upstream_error, domain_not_found, dns_not_using_namecheap