domains.register
Register a domain through Vee3.
The user or agent passes registrant contact details and expected_token_cost from domains.registration_quote. Use a real registrant email address the domain owner can access; the registrar may send a verification email that must be completed to keep the domain in good standing. Charges the quoted token cost on success.
Cost = 200 tokens + domain registration price in tokens.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| years | No | Registration term in years. | |
| domain | Yes | Domain name to register (for example example.com). | |
| contact | Yes | Registrant contact used for Registrant, Admin, Tech, and AuxBilling roles. Object with first_name, last_name, address1, city, state_province, postal_code, country (two-letter code), phone (format +NNN.NNNNNNNNNN), and email_address (a real inbox the registrant can access; the registrar may send a verification email that must be completed). Optional fields: address2 and organization_name. | |
| enable_privacy | No | Whether to enable free WhoisGuard privacy protection when available. | |
| expected_token_cost | Yes | Token cost from a fresh domains.registration_quote response. Required to prevent surprise charges. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| years | No | Registration term in years. | |
| domain | No | Registered domain name. | |
| order_id | No | Namecheap order identifier for the registration purchase. | |
| expires_at | No | Domain expiration timestamp when known. | |
| registered | No | Whether registration completed successfully. | |
| token_cost | No | Tokens charged for this registration (200 service tokens plus the domain price in tokens). | |
| privacy_enabled | No | Whether WhoisGuard privacy protection is enabled. | |
| namecheap_domain_id | No | Namecheap domain identifier for the managed domain. |