Skip to main content
POST
Purchase a root-domain registration and create its pending connection.

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 one-time root-domain registration purchase

One-time root-domain registration for email infrastructure. 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. Do not include https:// or a subdomain.

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, and its root domain is used for reply forwarding.

purchaseConfirmed
boolean
required

Must be true. This confirms the quoted customer price and authorizes the irreversible purchase.

Response

Registered domain and its pending branded-domain connection

domain
object

The pending branded-domain connection created for the newly registered domain

pricing
object

Registration quote: basePrice, priceMultiplier, and customerPrice in USD. This is not the monthly connection add-on price.

dnsRecord
object

A record used by the branded-domain connection for SSL termination and routing

providerStatus
string

Registration status from the managed domain service