Update Domain

curl --request PATCH \
  --url https://api.whop.com/api/v1/domains/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "apple_pay": {},
  "email": {},
  "metadata": {
    "project": "storefront"
  },
  "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/{id}"

payload = {
    "apple_pay": {},
    "email": {},
    "metadata": { "project": "storefront" },
    "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.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    apple_pay: {},
    email: {},
    metadata: {project: 'storefront'},
    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/{id}', 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/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    'apple_pay' => [
        
    ],
    'email' => [
        
    ],
    'metadata' => [
        'project' => 'storefront'
    ],
    '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/{id}"

	payload := strings.NewReader("{\n  \"apple_pay\": {},\n  \"email\": {},\n  \"metadata\": {\n    \"project\": \"storefront\"\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("PATCH", 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.patch("https://api.whop.com/api/v1/domains/{id}")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"apple_pay\": {},\n  \"email\": {},\n  \"metadata\": {\n    \"project\": \"storefront\"\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/{id}")

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

request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"apple_pay\": {},\n  \"email\": {},\n  \"metadata\": {\n    \"project\": \"storefront\"\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>"
  }
}

PATCH

domains

{id}

Update Domain

curl --request PATCH \
  --url https://api.whop.com/api/v1/domains/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "apple_pay": {},
  "email": {},
  "metadata": {
    "project": "storefront"
  },
  "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/{id}"

payload = {
    "apple_pay": {},
    "email": {},
    "metadata": { "project": "storefront" },
    "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.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    apple_pay: {},
    email: {},
    metadata: {project: 'storefront'},
    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/{id}', 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/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    'apple_pay' => [
        
    ],
    'email' => [
        
    ],
    'metadata' => [
        'project' => 'storefront'
    ],
    '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/{id}"

	payload := strings.NewReader("{\n  \"apple_pay\": {},\n  \"email\": {},\n  \"metadata\": {\n    \"project\": \"storefront\"\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("PATCH", 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.patch("https://api.whop.com/api/v1/domains/{id}")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"apple_pay\": {},\n  \"email\": {},\n  \"metadata\": {\n    \"project\": \"storefront\"\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/{id}")

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

request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"apple_pay\": {},\n  \"email\": {},\n  \"metadata\": {\n    \"project\": \"storefront\"\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>"
  }
}

Authorizations

Authorization

string

header

required

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

Api-Version-Date

string

Pins the request to a dated API version.

Example:

"2026-10-15-1"

Path Parameters

string

required

Domain ID, prefixed dom_, or a hostname such as example.com; a bare name looks up .com.

Body

application/json

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

Replacement custom string keys and values.

Show child attributes

Example:

{ "project": "storefront" }

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 updated

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

Update Domain

Authorizations

Headers

Path Parameters

Body

Response