Create Domain
Creates an unverified claim and returns DNS instructions. A claim does not reserve the hostname globally. Publish its unique TXT record; ownership verification, DNS checks, and certificate provisioning run automatically. Unverified claims are deleted after 48 hours.
Authorizations
An Account API key, account-scoped JWT, App API key, or user OAuth token. Prepend the key or token with Bearer, for example Bearer ***************************.
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-09-09"
Body
App ID, prefixed app_. The app must belong to the account.
"app_xxxxxxxxxxxxxx"
Bare hostname, such as example.com or checkout.example.com. 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.
Custom string keys and values.
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 claim created
ID of the account claiming or owning this domain, prefixed biz_.
"biz_xxxxxxxxxxxxxx"
ID of the app assigned to this domain, prefixed app_.
"app_xxxxxxxxxxxxxx"
Cloudflare's latest certificate issuance status.
When the domain claim was created, as an ISO 8601 timestamp.
"2026-01-01T12:00:00.000Z"
Result of the most recent DNS routing check. Ownership is verified separately.
pending, valid, invalid, unknown "pending"
Normalized hostname, such as checkout.example.com.
"shop.example.com"
Cloudflare's latest hostname activation status.
Domain ID, prefixed dom_.
"dom_xxxxxxxxxxxxxx"
When DNS and provider state were last checked, as an ISO 8601 timestamp.
Custom string keys and values attached to this domain.
Domain lifecycle. Only active domains resolve to their app.
pending_verification, provisioning, active, action_required, deleting, removed "deleting"
When the domain was last updated, as an ISO 8601 timestamp.
"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"
When Whop verified the ownership TXT record, as an ISO 8601 timestamp.

