Create Domain

curl --request POST \
  --url https://api.whop.com/api/v1/domains \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "domain": "store.example.com",
  "account_id": "<string>",
  "apple_pay": {},
  "email": {},
  "metadata": {
    "project": "website"
  },
  "pixel": {},
  "registration": {
    "auth_code": "Tr4nsfer-Code",
    "auto_renew": true,
    "payment_method_id": "<string>"
  },
  "verification": {},
  "website": {
    "app_id": "app_xxxxxxxxxxxxxx"
  }
}
'

import requests

url = "https://api.whop.com/api/v1/domains"

payload = {
    "domain": "store.example.com",
    "account_id": "<string>",
    "apple_pay": {},
    "email": {},
    "metadata": { "project": "website" },
    "pixel": {},
    "registration": {
        "auth_code": "Tr4nsfer-Code",
        "auto_renew": True,
        "payment_method_id": "<string>"
    },
    "verification": {},
    "website": { "app_id": "app_xxxxxxxxxxxxxx" }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    domain: 'store.example.com',
    account_id: '<string>',
    apple_pay: {},
    email: {},
    metadata: {project: 'website'},
    pixel: {},
    registration: {auth_code: 'Tr4nsfer-Code', auto_renew: true, payment_method_id: '<string>'},
    verification: {},
    website: {app_id: 'app_xxxxxxxxxxxxxx'}
  })
};

fetch('https://api.whop.com/api/v1/domains', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.whop.com/api/v1/domains",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'domain' => 'store.example.com',
    'account_id' => '<string>',
    'apple_pay' => [
        
    ],
    'email' => [
        
    ],
    'metadata' => [
        'project' => 'website'
    ],
    'pixel' => [
        
    ],
    'registration' => [
        'auth_code' => 'Tr4nsfer-Code',
        'auto_renew' => true,
        'payment_method_id' => '<string>'
    ],
    'verification' => [
        
    ],
    'website' => [
        'app_id' => 'app_xxxxxxxxxxxxxx'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.whop.com/api/v1/domains"

	payload := strings.NewReader("{\n  \"domain\": \"store.example.com\",\n  \"account_id\": \"<string>\",\n  \"apple_pay\": {},\n  \"email\": {},\n  \"metadata\": {\n    \"project\": \"website\"\n  },\n  \"pixel\": {},\n  \"registration\": {\n    \"auth_code\": \"Tr4nsfer-Code\",\n    \"auto_renew\": true,\n    \"payment_method_id\": \"<string>\"\n  },\n  \"verification\": {},\n  \"website\": {\n    \"app_id\": \"app_xxxxxxxxxxxxxx\"\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.whop.com/api/v1/domains")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"domain\": \"store.example.com\",\n  \"account_id\": \"<string>\",\n  \"apple_pay\": {},\n  \"email\": {},\n  \"metadata\": {\n    \"project\": \"website\"\n  },\n  \"pixel\": {},\n  \"registration\": {\n    \"auth_code\": \"Tr4nsfer-Code\",\n    \"auto_renew\": true,\n    \"payment_method_id\": \"<string>\"\n  },\n  \"verification\": {},\n  \"website\": {\n    \"app_id\": \"app_xxxxxxxxxxxxxx\"\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.whop.com/api/v1/domains")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"domain\": \"store.example.com\",\n  \"account_id\": \"<string>\",\n  \"apple_pay\": {},\n  \"email\": {},\n  \"metadata\": {\n    \"project\": \"website\"\n  },\n  \"pixel\": {},\n  \"registration\": {\n    \"auth_code\": \"Tr4nsfer-Code\",\n    \"auto_renew\": true,\n    \"payment_method_id\": \"<string>\"\n  },\n  \"verification\": {},\n  \"website\": {\n    \"app_id\": \"app_xxxxxxxxxxxxxx\"\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "account_id": "biz_xxxxxxxxxxxxxx",
  "apple_pay": {
    "state": "pending"
  },
  "availability": {
    "available": true,
    "premium": false,
    "price": {
      "amount": "-1234.56",
      "currency": "usd",
      "decimals": 2,
      "display_decimals": 2
    },
    "renewal_price": {
      "amount": "-1234.56",
      "currency": "usd",
      "decimals": 2,
      "display_decimals": 2
    },
    "score": 75,
    "transfer_price": {
      "amount": "-1234.56",
      "currency": "usd",
      "decimals": 2,
      "display_decimals": 2
    }
  },
  "created_at": "2026-01-01T12:00:00.000Z",
  "domain": "shop.com",
  "email": {
    "state": "pending"
  },
  "id": "dom_xxxxxxxxxxxxxx",
  "issues": [
    {
      "capability": "verification",
      "code": "verification_required",
      "code_block": null,
      "dns_records": [
        {
          "name": "_whop.shop.example.com",
          "type": "TXT",
          "value": "whop-domain-verification=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
        }
      ],
      "message": "Publish this TXT record to prove you own the domain. Verification runs automatically."
    }
  ],
  "metadata": {
    "project": "website"
  },
  "owned_by": {
    "id": "biz_xxxxxxxxxxxxxx",
    "logo_url": null,
    "route": "biz_xxxxxxxxxxxxxx",
    "title": "Rival Shop"
  },
  "pixel": {
    "state": "pending"
  },
  "platform": {
    "state": "pending"
  },
  "public_record": {
    "dnssec": false,
    "expires_at": "2026-01-01T12:00:00.000Z",
    "name_servers": [
      "ns1.example.com"
    ],
    "registered_at": "2026-01-01T12:00:00.000Z",
    "registrant": {
      "address": "Burlington\nMA",
      "contact_url": "https://registrar.example/contact/example.com",
      "country": "US",
      "email": null,
      "name": null,
      "organization": "Privacy Protect, LLC",
      "phone": null
    },
    "registrar": {
      "iana_id": "9999",
      "name": "Example Registrar, Inc.",
      "url": "https://registrar.example"
    },
    "statuses": [
      "client transfer prohibited"
    ],
    "updated_at": "2026-01-01T12:00:00.000Z"
  },
  "registration": {
    "amount_due": {
      "amount": "-1234.56",
      "currency": "usd",
      "decimals": 2,
      "display_decimals": 2
    },
    "auto_renew": true,
    "expires_at": null,
    "method": "transfer",
    "payment_method_id": null,
    "phase": "awaiting_payment",
    "purchase_url": "https://whop.com/checkout/ch_xxxxxxxxxxxxxx/",
    "state": "pending"
  },
  "stats": {
    "unique_visitors_last_7_days": 0
  },
  "status": "pending",
  "updated_at": "2026-01-01T12:00:00.000Z",
  "verification": {
    "state": "pending",
    "verification_expires_at": "2026-01-01T12:00:00.000Z"
  },
  "website": {
    "app": {
      "base_url": "https://domains-spec-site.whop.site",
      "id": "app_xxxxxxxxxxxxxx"
    },
    "state": "pending"
  }
}

{
  "error": {
    "message": "account_id is required",
    "type": "bad_request",
    "code": "<string>"
  }
}

{
  "error": {
    "message": "account_id is required",
    "type": "bad_request",
    "code": "<string>"
  }
}

Domains

Create Domain

Adds a domain to your account with the capabilities you want.

Pass registration to buy the domain through Whop; it’s the default when you pass no capability. Pay its amount_due at purchase_url, or pass registration.payment_method_id to charge a saved card. Whop then registers it, runs its DNS, and renews it every year while auto_renew is on.

Pass registration.auth_code to transfer in a domain you own at another registrar. The transfer starts once its amount_due is paid, or at once when amount_due is null. While registration.phase is transferring, its issues say what the transfer needs from you.

Pass verification to connect a domain you registered elsewhere: its issues list the TXT and routing records to publish. Pass website with an app_id to serve that app on the domain.

To change a domain you already have, update it instead. Adding a domain this account deleted revives it under its original ID.

POST

domains

Create Domain

curl --request POST \
  --url https://api.whop.com/api/v1/domains \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "domain": "store.example.com",
  "account_id": "<string>",
  "apple_pay": {},
  "email": {},
  "metadata": {
    "project": "website"
  },
  "pixel": {},
  "registration": {
    "auth_code": "Tr4nsfer-Code",
    "auto_renew": true,
    "payment_method_id": "<string>"
  },
  "verification": {},
  "website": {
    "app_id": "app_xxxxxxxxxxxxxx"
  }
}
'

import requests

url = "https://api.whop.com/api/v1/domains"

payload = {
    "domain": "store.example.com",
    "account_id": "<string>",
    "apple_pay": {},
    "email": {},
    "metadata": { "project": "website" },
    "pixel": {},
    "registration": {
        "auth_code": "Tr4nsfer-Code",
        "auto_renew": True,
        "payment_method_id": "<string>"
    },
    "verification": {},
    "website": { "app_id": "app_xxxxxxxxxxxxxx" }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    domain: 'store.example.com',
    account_id: '<string>',
    apple_pay: {},
    email: {},
    metadata: {project: 'website'},
    pixel: {},
    registration: {auth_code: 'Tr4nsfer-Code', auto_renew: true, payment_method_id: '<string>'},
    verification: {},
    website: {app_id: 'app_xxxxxxxxxxxxxx'}
  })
};

fetch('https://api.whop.com/api/v1/domains', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.whop.com/api/v1/domains",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'domain' => 'store.example.com',
    'account_id' => '<string>',
    'apple_pay' => [
        
    ],
    'email' => [
        
    ],
    'metadata' => [
        'project' => 'website'
    ],
    'pixel' => [
        
    ],
    'registration' => [
        'auth_code' => 'Tr4nsfer-Code',
        'auto_renew' => true,
        'payment_method_id' => '<string>'
    ],
    'verification' => [
        
    ],
    'website' => [
        'app_id' => 'app_xxxxxxxxxxxxxx'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.whop.com/api/v1/domains"

	payload := strings.NewReader("{\n  \"domain\": \"store.example.com\",\n  \"account_id\": \"<string>\",\n  \"apple_pay\": {},\n  \"email\": {},\n  \"metadata\": {\n    \"project\": \"website\"\n  },\n  \"pixel\": {},\n  \"registration\": {\n    \"auth_code\": \"Tr4nsfer-Code\",\n    \"auto_renew\": true,\n    \"payment_method_id\": \"<string>\"\n  },\n  \"verification\": {},\n  \"website\": {\n    \"app_id\": \"app_xxxxxxxxxxxxxx\"\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.whop.com/api/v1/domains")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"domain\": \"store.example.com\",\n  \"account_id\": \"<string>\",\n  \"apple_pay\": {},\n  \"email\": {},\n  \"metadata\": {\n    \"project\": \"website\"\n  },\n  \"pixel\": {},\n  \"registration\": {\n    \"auth_code\": \"Tr4nsfer-Code\",\n    \"auto_renew\": true,\n    \"payment_method_id\": \"<string>\"\n  },\n  \"verification\": {},\n  \"website\": {\n    \"app_id\": \"app_xxxxxxxxxxxxxx\"\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.whop.com/api/v1/domains")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"domain\": \"store.example.com\",\n  \"account_id\": \"<string>\",\n  \"apple_pay\": {},\n  \"email\": {},\n  \"metadata\": {\n    \"project\": \"website\"\n  },\n  \"pixel\": {},\n  \"registration\": {\n    \"auth_code\": \"Tr4nsfer-Code\",\n    \"auto_renew\": true,\n    \"payment_method_id\": \"<string>\"\n  },\n  \"verification\": {},\n  \"website\": {\n    \"app_id\": \"app_xxxxxxxxxxxxxx\"\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "account_id": "biz_xxxxxxxxxxxxxx",
  "apple_pay": {
    "state": "pending"
  },
  "availability": {
    "available": true,
    "premium": false,
    "price": {
      "amount": "-1234.56",
      "currency": "usd",
      "decimals": 2,
      "display_decimals": 2
    },
    "renewal_price": {
      "amount": "-1234.56",
      "currency": "usd",
      "decimals": 2,
      "display_decimals": 2
    },
    "score": 75,
    "transfer_price": {
      "amount": "-1234.56",
      "currency": "usd",
      "decimals": 2,
      "display_decimals": 2
    }
  },
  "created_at": "2026-01-01T12:00:00.000Z",
  "domain": "shop.com",
  "email": {
    "state": "pending"
  },
  "id": "dom_xxxxxxxxxxxxxx",
  "issues": [
    {
      "capability": "verification",
      "code": "verification_required",
      "code_block": null,
      "dns_records": [
        {
          "name": "_whop.shop.example.com",
          "type": "TXT",
          "value": "whop-domain-verification=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
        }
      ],
      "message": "Publish this TXT record to prove you own the domain. Verification runs automatically."
    }
  ],
  "metadata": {
    "project": "website"
  },
  "owned_by": {
    "id": "biz_xxxxxxxxxxxxxx",
    "logo_url": null,
    "route": "biz_xxxxxxxxxxxxxx",
    "title": "Rival Shop"
  },
  "pixel": {
    "state": "pending"
  },
  "platform": {
    "state": "pending"
  },
  "public_record": {
    "dnssec": false,
    "expires_at": "2026-01-01T12:00:00.000Z",
    "name_servers": [
      "ns1.example.com"
    ],
    "registered_at": "2026-01-01T12:00:00.000Z",
    "registrant": {
      "address": "Burlington\nMA",
      "contact_url": "https://registrar.example/contact/example.com",
      "country": "US",
      "email": null,
      "name": null,
      "organization": "Privacy Protect, LLC",
      "phone": null
    },
    "registrar": {
      "iana_id": "9999",
      "name": "Example Registrar, Inc.",
      "url": "https://registrar.example"
    },
    "statuses": [
      "client transfer prohibited"
    ],
    "updated_at": "2026-01-01T12:00:00.000Z"
  },
  "registration": {
    "amount_due": {
      "amount": "-1234.56",
      "currency": "usd",
      "decimals": 2,
      "display_decimals": 2
    },
    "auto_renew": true,
    "expires_at": null,
    "method": "transfer",
    "payment_method_id": null,
    "phase": "awaiting_payment",
    "purchase_url": "https://whop.com/checkout/ch_xxxxxxxxxxxxxx/",
    "state": "pending"
  },
  "stats": {
    "unique_visitors_last_7_days": 0
  },
  "status": "pending",
  "updated_at": "2026-01-01T12:00:00.000Z",
  "verification": {
    "state": "pending",
    "verification_expires_at": "2026-01-01T12:00:00.000Z"
  },
  "website": {
    "app": {
      "base_url": "https://domains-spec-site.whop.site",
      "id": "app_xxxxxxxxxxxxxx"
    },
    "state": "pending"
  }
}

{
  "error": {
    "message": "account_id is required",
    "type": "bad_request",
    "code": "<string>"
  }
}

{
  "error": {
    "message": "account_id is required",
    "type": "bad_request",
    "code": "<string>"
  }
}

Authorizations

Authorization

string

header

required

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

Idempotency-Key

string

A unique key that makes this request safe to retry. See Idempotent requests.

Maximum string length: 255

Example:

"d9105228-4a08-46b1-8b91-42fed586d383"

Api-Version-Date

string

Pins the request to a dated API version.

Example:

"2026-10-15-1"

Body

application/json

domain

string

required

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.

Example:

"store.example.com"

account_id

string

Account ID, prefixed biz_. Required for user credentials; otherwise defaults to the credential's account.

apple_pay

object | null

Accept Apple Pay at checkout on the domain. It needs no other capability. Whop registers the domain with Apple: it stays pending until Apple answers, then turns ready, or action_required when Apple couldn't fetch the domain association file. Serve the file, then check the domain to register it again. Pass null to turn Apple Pay off: Whop removes the domain from Apple, and the domain stays, like releasing any other capability.

object | null

Send and receive email on the domain. Only a domain bought through Whop, or a subdomain of one in the same account, can have it. Whop publishes the DNS records and stays pending until its email provider verifies them, then turns ready. Pass null to remove email.

metadata

object

Custom string keys and values.

Show child attributes

Example:

{ "project": "website" }

pixel

object | null

Track page views on the domain with the Whop pixel. It needs no other capability: it stays pending until the pixel records a page view, and turns action_required if it goes 7 days without one. Pass null to stop tracking.

registration

object | null

Buy the domain through Whop, or transfer in a domain you own elsewhere with auth_code, then renew it every year and let Whop run its DNS. Pass null to release an unpaid or failed purchase, or to cancel a transfer while its current registrar can still stop it.

Show child attributes

verification

object | null

Prove you control the domain's DNS: Whop returns a TXT record to publish in issues, and whoever publishes it owns the domain on Whop. Pass null to release it. Can't be combined with registration.

website

object | null

Serve a Whop website on the domain. Pass null to stop serving it; the domain keeps its other capabilities.

Show child attributes

Response

Domain created

account_id

string | null

required

ID of the account the domain belongs to, prefixed biz_.

Example:

"biz_xxxxxxxxxxxxxx"

apple_pay

object | null

required

Offering Apple Pay at checkouts served from the domain. null when not enrolled or not visible to you.

Show child attributes

availability

object | null

required

Whether you can register the hostname and what it costs. Set only when no domain on Whop has it.

Show child attributes

created_at

string | null

required

When the domain was created, as an ISO 8601 timestamp.

Example:

"2026-01-01T12:00:00.000Z"

domain

string

required

Normalized hostname, such as checkout.example.com.

Example:

"shop.com"

object | null

required

Sending and receiving email on the domain through Whop. null when not wanted, or when the domain belongs to an account you can't read.

Show child attributes

string | null

required

Domain ID, prefixed dom_. null when no domain on Whop has this hostname.

Example:

"dom_xxxxxxxxxxxxxx"

issues

object[]

required

Show child attributes

metadata

object

required

Custom string keys and values attached to this domain. Empty when the domain isn't yours.

Show child attributes

Example:

{ "project": "website" }

owned_by

object | null

required

The account that has proven it owns this hostname on Whop, which can be your own. null when no account has.

Show child attributes

pixel

object | null

required

Tracking page views on the domain with the Whop pixel. null when not tracked or not visible to you.

Show child attributes

platform

object | null

required

An address on a zone Whop runs, such as example.whop.site, that follows its app's route. null for other domains or when not visible to you.

Show child attributes

public_record

object | null

required

The domain's public registration record (RDAP), read when you retrieve it by hostname. null for domains on Whop, available domains, or a record that couldn't be read.

Show child attributes

registration

object | null

required

Buying the domain through Whop, renewing it, and running its DNS. null when not wanted or not visible to you.

Show child attributes

stats

object | null

required

Traffic on the domain. null when the domain isn't on Whop or isn't visible to you.

Show child attributes

status

enum<string> | null

required

The most pressing state of the domain's capabilities: releasing, then action_required, then pending, then ready. idle when it wants nothing.

Available options:

idle,

pending,

ready,

action_required,

releasing,

null

Example:

"pending"

updated_at

string | null

required

When the domain was last updated, as an ISO 8601 timestamp.

Example:

"2026-01-01T12:00:00.000Z"

verification

object | null

required

Proving you control the domain's DNS with a TXT record. null when not wanted or not visible to you.

Show child attributes

website

object | null

required

Serving a Whop website on the domain. null when not wanted.

Show child attributes

Introduction

Reference

Core Resources

Payments

Money

Commerce

Websites

Ads

Analytics

Communication

Partners

Workforce

Media

Developer

Create Domain

Authorizations

Headers

Body

Response