Provider Domains

Checkout Purchase Domains

Buy one or more sending domains. SPENDS REAL CREDITS — unrestricted, same as the app; there is no per-key spend cap.

Send an Idempotency-Key header to make a retry safe (a repeat with the same key returns the original response instead of buying twice). Returns 402 if the credit hold can't clear, 422 if the org's plan can't fund a purchase at all (same gate the app UI checks), 400 for a pilot-only provider or an unsupported TLD.

post/provider-domains/checkout-purchase

Request

  • Base URL: https://be.graph8.com/api/v1
  • URL: https://be.graph8.com/api/v1/provider-domains/checkout-purchase
  • Auth: HTTP bearer

Headers

Authorizationstring nullable
X-Target-Org-Idstring nullable

Request body

domainsstring[] required

Domains to buy, e.g. ['acme-outreach.com']. Up to 50 per request.

spare_domainsstring[]

Extra domains bought as spare warm-up capacity (warm from day 0, excluded from sending until promoted). Up to 50 per request.

periodinteger

Registration period, in years

contact_infoobject required

Registrant contact used for domain registration

provider'registrar' | 'managed' | 'pilot'

Provisioning path. 'pilot' is limited to allowlisted orgs and otherwise returns 400.

Response

Successful Response

dataobject required

Changes

No recorded changes to this operation across all 2 revisions of this API.