Skip to main content
POST
Purchase a root-domain registration.

Authorizations

X-API-Key
string
header
required

Company API key - scoped to a specific company. Generate from the Integrations page in your dashboard.

Body

application/json

Confirmed root-domain registration purchase with yearly renewal

Root-domain registration for email infrastructure, renewed yearly. This is separate from the $5/month branded-domain connection add-on for SSL termination and routing.

companyId
string
required

Company that will own the registered domain and connection

domain
string
required

Available root domain to purchase, e.g. example.com. Premium names, https://, and subdomains are not supported.

contactDetails
object
required

Registrant data: firstName, lastName, email, phone, address1, city, province, postalCode, and country; organization is optional. The registrant email is reused for DMARC reports. Domain forwarding is not configured by this purchase path.

paymentIntentId
string
required

Successful Stripe PaymentIntent created for this exact company and domain.

connectedAccount
string

Stripe connected account returned when the payment was created, if applicable.

Response

The registered domain

domain
object

The newly registered domain, unconnected until the customer connects it; it uses no connection slot until then

pricing
object

Registration price in USD: customerPrice (first payment) and renewalPrice (billed yearly), with basePrice, renewalBasePrice, and priceMultiplier. This is not the monthly connection add-on price.

providerStatus
string

Registration status from the managed domain service