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
`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

Input Schema (JSON Schema)

{
  "properties": {
    "additional_details": {
      "description": "Additional registration data, possible values depends on TLD",
      "properties": {},
      "type": "object"
    },
    "coupons": {
      "description": "Discount coupon codes",
      "items": {
        "description": "coupons parameter",
        "type": "string"
      },
      "type": "array"
    },
    "domain": {
      "description": "Domain name",
      "type": "string"
    },
    "domain_contacts": {
      "description": "Domain contact information",
      "properties": {
        "admin_id": {
          "description": "Administrative contact WHOIS record ID",
          "type": "integer"
        },
        "billing_id": {
          "description": "Billing contact WHOIS record ID",
          "type": "integer"
        },
        "owner_id": {
          "description": "Owner contact WHOIS record ID",
          "type": "integer"
        },
        "tech_id": {
          "description": "Technical contact WHOIS record ID",
          "type": "integer"
        }
      },
      "type": "object"
    },
    "item_id": {
      "description": "Catalog price item ID",
      "type": "string"
    },
    "payment_method_id": {
      "description": "Payment method ID, default will be used if not provided",
      "type": "integer"
    }
  },
  "required": [
    "domain",
    "item_id"
  ],
  "type": "object"
}

This server cannot be installed

hostinger-api-mcp