register_domain
Register a new domain name with optional WHOIS privacy, DNS management, and custom nameservers. Requires explicit user confirmation before spending from your account.
Instructions
Register a new domain name. Requires scope domains:write. SPENDS MONEY: places a register ORDER + invoice (WHMCS has no "register now" API) that the registrar fulfils once accepted/paid — the returned status starts Pending. Pass confirm:true only after the user has approved the cost. domain is the full name, e.g. example.com; years is the registration term (1-10, default 1); nameservers is an optional list of up to 5 custom nameserver hostnames (omit to use the registrar default); idProtection/dnsManagement are optional WHOIS-privacy / DNS-hosting add-ons (registrar-dependent). Check availability first with check_domain_availability and price with get_tld_pricing.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| years | No | Registration term in years (1-10, default 1). | |
| domain | Yes | The domain to register, e.g. example.com. | |
| confirm | Yes | Set to true to execute. This operation spends from your account balance and/or is irreversible; only pass true after the user has explicitly approved. Omit or false → the tool refuses and makes no API call. | |
| nameservers | No | Optional custom nameservers (up to 5); omit to use the registrar default. | |
| idProtection | No | Optional WHOIS-privacy add-on (registrar-dependent). | |
| dnsManagement | No | Optional DNS-hosting add-on (registrar-dependent). |