domains_purchaseNewDomainV1
Purchase and register a new domain name. Automatically uses default payment or WHOIS details if not provided. Includes validation for TLD-specific registration data. Ideal for domain registration and management.
Instructions
Purchase and register a new domain name.
If registration fails, login to hPanel and check domain registration status.
If no payment method is provided, your default payment method will be used automatically.
If no WHOIS information is provided, default contact information for that TLD will be used. Before making request, ensure WHOIS information for desired TLD exists in your account.
Some TLDs require additional_details to be provided and these will be validated before completing purchase.
Use this endpoint to register new domains for users.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| additional_details | No | Additional registration data, possible values depends on TLD | |
| coupons | No | Discount coupon codes | |
| domain | Yes | Domain name | |
| domain_contacts | No | Domain contact information | |
| item_id | Yes | Catalog price item ID | |
| payment_method_id | No | Payment method ID, default will be used if not provided |
Implementation Reference
- types.d.ts:655-683 (schema)TypeScript interface definition for the input parameters and generic response type of the 'domains_purchaseNewDomainV1' MCP tool, auto-generated from OpenAPI specification. This defines the tool schema for purchasing and registering a new domain name.
"domains_purchaseNewDomainV1": { params: { /** * Domain name */ domain: string; /** * Catalog price item ID */ item_id: string; /** * Payment method ID, default will be used if not provided */ payment_method_id?: number; /** * Domain contact information */ domain_contacts?: object; /** * Additional registration data, possible values depends on TLD */ additional_details?: object; /** * Discount coupon codes */ coupons?: array; }; response: any; // Response structure will depend on the API };