Create Domain
Buys a domain through Whop, or connects one you registered elsewhere.
A bought domain starts awaiting_payment. Pay its amount_due at purchase_url, or pass payment_method_id to charge a saved card. Whop then registers it, hosts its DNS, issues its certificate and serves the app, and renews it every year while auto_renew is on. An unpaid purchase is removed after 7 days.
With mode: external, Whop returns the DNS records to publish instead. Verification and certificate setup run automatically, and unverified claims are deleted after 48 hours. A claim doesn’t reserve the hostname.
Authorizations
An account-scoped user token or a user OAuth token. Prepend the key or token with Bearer, for example Bearer ***************************. See Auth & API keys for how to get each one.
Headers
A unique key that makes this request safe to retry. See Idempotent requests.
255"d9105228-4a08-46b1-8b91-42fed586d383"
Pins the request to a dated API version.
"2026-10-06-2"
Body
Bare hostname, such as example.com or checkout.example.com. A bought domain must be a root domain. Wildcards, paths, schemes, and ports are not accepted.
"store.example.com"
Account ID, prefixed biz_. Required for user credentials; otherwise defaults to the credential's account.
App ID, prefixed app_, for the domain to serve. The app must belong to the account. Required with mode: external.
"app_xxxxxxxxxxxxxx"
Custom string keys and values.
managed buys the domain through Whop; external connects a domain you registered elsewhere.
external, managed "external"
Saved card to charge for a bought domain and its renewals, prefixed payt_. It must belong to the signed-in user.
With mode: external, explicitly transfer a domain from its current owner after publishing this new claim's TXT proof. Create the claim after the current owner verified.
Response
Domain created
ID of the account claiming or owning this domain, prefixed biz_. null for a search result.
"biz_xxxxxxxxxxxxxx"
The charge the domain owes now. null when nothing is owed.
ID of the app the domain serves, prefixed app_. null for a search result or a bought domain without an app.
"app_xxxxxxxxxxxxxx"
Whether Whop charges the saved payment method to renew a bought domain before it expires. null for connected domains and search results.
true
When the domain was created, as an ISO 8601 timestamp. null for a search result.
"2026-01-01T12:00:00.000Z"
Normalized hostname, such as checkout.example.com.
"shop.com"
When the registration of a bought domain expires unless renewed, as an ISO 8601 timestamp. null for connected domains and search results.
null
Domain ID, prefixed dom_. null for a search result.
"dom_xxxxxxxxxxxxxx"
Custom string keys and values attached to this domain. Empty for a search result.
managed for a domain bought and renewed through Whop; external for a domain registered elsewhere and connected with DNS records. null for a search result.
external, managed, null "managed"
ID of the saved card charged for a bought domain, prefixed payt_. null when none is set.
null
The domain's public registration record (RDAP), read when you retrieve it by hostname. null for your own domains, available domains, or a record that couldn't be read.
Link to pay the charge the domain owes now: its registration, or a yearly renewal. null when nothing is owed.
"https://whop.com/checkout/ch_xxxxxxxxxxxxxx/"
Whether you can register the domain and what it costs. Set for search results and hostname lookups; null for your own domains.
Domain lifecycle. Only active domains serve their app. null for a search result.
pending_verification, awaiting_payment, registering, provisioning, active, action_required, deleting, expired, failed, removed, null "awaiting_payment"
When the domain was last updated, as an ISO 8601 timestamp. null for a search result.
"2026-01-01T12:00:00.000Z"
When an unverified claim is automatically deleted, 48 hours after creation, as an ISO 8601 timestamp.
"2026-01-01T12:00:00.000Z"

