Domains

Purchase Domains

Purchase domains for a workspace via API.

Prerequisites:

  • Workspace must have a saved payment method (via Stripe subscription)
  • All domains must be available for registration
  • Registrant contact info (contact_info) is required

Guardrails: at most PUBLIC_DOMAIN_PURCHASE_MAX_DOMAINS_PER_CALL domains per call (default 10, over -> 400). An optional rolling-24h spend cap per workspace (PUBLIC_DOMAIN_PURCHASE_DAILY_CAP_CENTS, over -> 429) is off by default. Send an Idempotency-Key header to make retries safe.

The payment is charged immediately using the saved payment method.

post/domains/purchase

Request

  • Base URL: https://public.outreach2day.com
  • URL: https://public.outreach2day.com/domains/purchase
  • Auth: HTTP bearer

Query parameters

dryRunboolean

Validate and price the order without charging or registering anything.

Headers

Idempotency-Keystring nullable

Recommended. Same key + same body within 24h returns the first response without a second charge; same key + different body -> 409.

Request body

workspace_idinteger required

Workspace ID where domains should be created

domainsstring[] required

List of root domains to purchase

Example request

{
  "contact_info": {
    "first_name": "John",
    "last_name": "Doe",
    "real_address": "123 Main St",
    "city": "Austin",
    "state_province": "Texas",
    "postal_code": "78701",
    "country": "United States",
    "phone": "+15551234567",
    "email_address": "john@acme.com",
    "organization_name": "ACME Inc",
    "job_title": "Founder"
  }
}

Response

Successful Response

statusstring required
messagestring required
domains_purchasedstring[] required
total_charged_centsinteger required
invoice_idstring nullable
estimated_total_centsinteger nullable

Changes

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