Name icon

Name

Interact with Name API

Domain → Create A Domain

AI-generated

Summary

Creates a new domain registration under the authenticated account with specified settings and contacts.

Inputs

  • domainName (required) — The punycode-encoded value of the domain name (e.g., example.com).
  • purchaseType (required) — Defaults to "registration" but should be copied from a Search or checkAvailability result.
  • years (required) — Number of years to register. Defaults to 1, cannot exceed 10. Some TLDs require longer periods (e.g., .AI requires 2 years).
  • adminFirstName (required) — The first name of the admin contact.
  • adminLastName (required) — The last name of the admin contact.
  • adminEmail (required) — Email address of the admin contact. Must be a valid email format (RFC 822).
  • adminPhone (required) — Phone number of the admin contact. Should follow E.164 international format: +[country code][number].
  • registrantFirstName (required) — The first name of the registrant contact.
  • registrantLastName (required) — The last name of the registrant contact.
  • registrantEmail (required) — Email address of the registrant contact. Must be a valid email format (RFC 822).
  • registrantPhone (required) — Phone number of the registrant contact. Should follow E.164 international format: +[country code][number].
  • techFirstName (required) — The first name of the technical contact.
  • techLastName (required) — The last name of the technical contact.
  • techEmail (required) — Email address of the technical contact. Must be a valid email format (RFC 822).
  • techPhone (required) — Phone number of the technical contact. Should follow E.164 international format: +[country code][number].
  • billingFirstName (required) — The first name of the billing contact.
  • billingLastName (required) — The last name of the billing contact.
  • billingEmail (required) — Email address of the billing contact. Must be a valid email format (RFC 822).
  • billingPhone (required) — Phone number of the billing contact. Should follow E.164 international format: +[country code][number].

Output shape

a single record

Returns the created domain details.

Examples

Example 1: Register a new domain for one year with default contact information.

Set domainName, years (default 1), and required contact fields (admin, registrant, tech, billing).

Example 2: Create a domain with specific TLD requirements (e.g., .AI) using purchaseType from a search result.

Pass purchaseType from checkAvailability, years matching the TLD requirement (e.g., 2), and complete contact details.

Links

Discussion