Update Domain
Reassigns a domain to another app in the same account, replaces its metadata, or changes how a bought domain renews. The hostname and owning account cannot be edited.
Authorizations
An Account API key, an App API key, an account access token, 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
Pins the request to a dated API version.
"2026-10-06-2"
Path Parameters
Domain ID, prefixed dom_. To retrieve, you can pass a hostname such as example.com instead; a bare name looks up .com.
Body
App ID, prefixed app_. Must belong to the same account. Pass null to detach a bought domain from its app; it keeps renewing.
For a bought domain, whether Whop charges its saved card to renew it before it expires.
Replacement custom string keys and values.
For a bought domain, the saved card to charge, prefixed payt_. It must belong to the signed-in user. Pass null to remove it.
Response
Domain updated
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"

