Update Account Preferences

curl --request PATCH \
  --url https://api.whop.com/api/v1/accounts/{account_id}/preferences \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "ads_certifications": {
    "prescription_drug_ads": {
      "status": "pending_information"
    }
  },
  "ads_reporting_currency": "eur",
  "ads_scheduling_timezone": "PST8PDT",
  "ads_triple_whale_integration": {
    "api_key": "tw_live_key_1234",
    "shop_domain": "custom-store.example.com"
  },
  "cards_auto_top_up": true,
  "cards_notifications": true,
  "dispute_fighter_enabled": true,
  "economic_intelligence_duration_key": "7_days",
  "subscription_failure_behavior": "none"
}
'

import requests

url = "https://api.whop.com/api/v1/accounts/{account_id}/preferences"

payload = {
    "ads_certifications": { "prescription_drug_ads": { "status": "pending_information" } },
    "ads_reporting_currency": "eur",
    "ads_scheduling_timezone": "PST8PDT",
    "ads_triple_whale_integration": {
        "api_key": "tw_live_key_1234",
        "shop_domain": "custom-store.example.com"
    },
    "cards_auto_top_up": True,
    "cards_notifications": True,
    "dispute_fighter_enabled": True,
    "economic_intelligence_duration_key": "7_days",
    "subscription_failure_behavior": "none"
}
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({
    ads_certifications: {prescription_drug_ads: {status: 'pending_information'}},
    ads_reporting_currency: 'eur',
    ads_scheduling_timezone: 'PST8PDT',
    ads_triple_whale_integration: {api_key: 'tw_live_key_1234', shop_domain: 'custom-store.example.com'},
    cards_auto_top_up: true,
    cards_notifications: true,
    dispute_fighter_enabled: true,
    economic_intelligence_duration_key: '7_days',
    subscription_failure_behavior: 'none'
  })
};

fetch('https://api.whop.com/api/v1/accounts/{account_id}/preferences', 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/accounts/{account_id}/preferences",
  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([
    'ads_certifications' => [
        'prescription_drug_ads' => [
                'status' => 'pending_information'
        ]
    ],
    'ads_reporting_currency' => 'eur',
    'ads_scheduling_timezone' => 'PST8PDT',
    'ads_triple_whale_integration' => [
        'api_key' => 'tw_live_key_1234',
        'shop_domain' => 'custom-store.example.com'
    ],
    'cards_auto_top_up' => true,
    'cards_notifications' => true,
    'dispute_fighter_enabled' => true,
    'economic_intelligence_duration_key' => '7_days',
    'subscription_failure_behavior' => 'none'
  ]),
  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/accounts/{account_id}/preferences"

	payload := strings.NewReader("{\n  \"ads_certifications\": {\n    \"prescription_drug_ads\": {\n      \"status\": \"pending_information\"\n    }\n  },\n  \"ads_reporting_currency\": \"eur\",\n  \"ads_scheduling_timezone\": \"PST8PDT\",\n  \"ads_triple_whale_integration\": {\n    \"api_key\": \"tw_live_key_1234\",\n    \"shop_domain\": \"custom-store.example.com\"\n  },\n  \"cards_auto_top_up\": true,\n  \"cards_notifications\": true,\n  \"dispute_fighter_enabled\": true,\n  \"economic_intelligence_duration_key\": \"7_days\",\n  \"subscription_failure_behavior\": \"none\"\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/accounts/{account_id}/preferences")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"ads_certifications\": {\n    \"prescription_drug_ads\": {\n      \"status\": \"pending_information\"\n    }\n  },\n  \"ads_reporting_currency\": \"eur\",\n  \"ads_scheduling_timezone\": \"PST8PDT\",\n  \"ads_triple_whale_integration\": {\n    \"api_key\": \"tw_live_key_1234\",\n    \"shop_domain\": \"custom-store.example.com\"\n  },\n  \"cards_auto_top_up\": true,\n  \"cards_notifications\": true,\n  \"dispute_fighter_enabled\": true,\n  \"economic_intelligence_duration_key\": \"7_days\",\n  \"subscription_failure_behavior\": \"none\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.whop.com/api/v1/accounts/{account_id}/preferences")

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  \"ads_certifications\": {\n    \"prescription_drug_ads\": {\n      \"status\": \"pending_information\"\n    }\n  },\n  \"ads_reporting_currency\": \"eur\",\n  \"ads_scheduling_timezone\": \"PST8PDT\",\n  \"ads_triple_whale_integration\": {\n    \"api_key\": \"tw_live_key_1234\",\n    \"shop_domain\": \"custom-store.example.com\"\n  },\n  \"cards_auto_top_up\": true,\n  \"cards_notifications\": true,\n  \"dispute_fighter_enabled\": true,\n  \"economic_intelligence_duration_key\": \"7_days\",\n  \"subscription_failure_behavior\": \"none\"\n}"

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

{
  "ads_agreement": {
    "accepted_at": "2026-01-01T12:00:00.000Z",
    "agreement_version": "2026-01-01",
    "printed_name": "Marcus Webb",
    "status": "not_required"
  },
  "ads_certifications": [
    {
      "approved_countries": [
        "<string>"
      ],
      "business_name": null,
      "business_type": "online_pharmacy",
      "certification_type": "prescription_drug_ads",
      "countries": [
        "<string>"
      ],
      "denial_reason": null,
      "request_id": "inrq_xxxxxxxxxxxxxx",
      "status": "not_started",
      "url": null
    }
  ],
  "ads_payment_methods": {
    "backup": {
      "id": "ldgr_xxxxxxxxxxxxxx",
      "type": "platform_balance",
      "card_brand": "visa",
      "exp_month": 10,
      "exp_year": 2031,
      "icon_url": "https://whop-assets-example.s3.amazonaws.com/uploads/image/2026-01-01/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
      "last4": "4242",
      "title": "Shine Time Auto Detailing"
    },
    "primary": {
      "id": "ldgr_xxxxxxxxxxxxxx",
      "type": "platform_balance",
      "card_brand": "visa",
      "exp_month": 10,
      "exp_year": 2031,
      "icon_url": "https://whop-assets-example.s3.amazonaws.com/uploads/image/2026-01-01/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
      "last4": "4242",
      "title": "Shine Time Auto Detailing"
    }
  },
  "ads_reporting_currency": "usd",
  "ads_scheduling_timezone": "America/New_York",
  "ads_triple_whale_integration": {
    "masked_api_key": "tw_live_********",
    "shop_domain": "shinetime.myshopify.com",
    "status": "requires_shop_domain"
  },
  "cards_auto_top_up": false,
  "cards_notifications": true,
  "dispute_fighter_enabled": false,
  "economic_intelligence": false,
  "economic_intelligence_ends_at": "2026-01-01T12:00:00.000Z",
  "economic_intelligence_fee_percentage": 1.5,
  "economic_intelligence_offers": [
    {
      "duration": 7,
      "duration_unit": "days",
      "fee_percentage": 1,
      "key": "7_days",
      "recommended": false
    }
  ],
  "subscription_failure_behavior": "cancel"
}

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

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

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

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

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

Accounts

Update Account Preferences

Updates the account’s preferences. Each top-level key present in the body is replaced as a whole; omitted keys are left untouched.

Required scopes depend on the preferences being updated:

Preferences	Required scope
`ads_payment_methods`, `ads_reporting_currency`, `ads_scheduling_timezone`, `ads_triple_whale_integration`, `ads_certifications`	`ad_campaign:create`
`cards_auto_top_up`, `cards_notifications`	`payout:account:update`
`dispute_fighter_enabled`	`payment:dispute`
`economic_intelligence_duration_key`	`company:update`

When updating preferences from multiple rows, all corresponding scopes are required for the account.

PATCH

accounts

{account_id}

preferences

Update Account Preferences

curl --request PATCH \
  --url https://api.whop.com/api/v1/accounts/{account_id}/preferences \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "ads_certifications": {
    "prescription_drug_ads": {
      "status": "pending_information"
    }
  },
  "ads_reporting_currency": "eur",
  "ads_scheduling_timezone": "PST8PDT",
  "ads_triple_whale_integration": {
    "api_key": "tw_live_key_1234",
    "shop_domain": "custom-store.example.com"
  },
  "cards_auto_top_up": true,
  "cards_notifications": true,
  "dispute_fighter_enabled": true,
  "economic_intelligence_duration_key": "7_days",
  "subscription_failure_behavior": "none"
}
'

import requests

url = "https://api.whop.com/api/v1/accounts/{account_id}/preferences"

payload = {
    "ads_certifications": { "prescription_drug_ads": { "status": "pending_information" } },
    "ads_reporting_currency": "eur",
    "ads_scheduling_timezone": "PST8PDT",
    "ads_triple_whale_integration": {
        "api_key": "tw_live_key_1234",
        "shop_domain": "custom-store.example.com"
    },
    "cards_auto_top_up": True,
    "cards_notifications": True,
    "dispute_fighter_enabled": True,
    "economic_intelligence_duration_key": "7_days",
    "subscription_failure_behavior": "none"
}
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({
    ads_certifications: {prescription_drug_ads: {status: 'pending_information'}},
    ads_reporting_currency: 'eur',
    ads_scheduling_timezone: 'PST8PDT',
    ads_triple_whale_integration: {api_key: 'tw_live_key_1234', shop_domain: 'custom-store.example.com'},
    cards_auto_top_up: true,
    cards_notifications: true,
    dispute_fighter_enabled: true,
    economic_intelligence_duration_key: '7_days',
    subscription_failure_behavior: 'none'
  })
};

fetch('https://api.whop.com/api/v1/accounts/{account_id}/preferences', 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/accounts/{account_id}/preferences",
  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([
    'ads_certifications' => [
        'prescription_drug_ads' => [
                'status' => 'pending_information'
        ]
    ],
    'ads_reporting_currency' => 'eur',
    'ads_scheduling_timezone' => 'PST8PDT',
    'ads_triple_whale_integration' => [
        'api_key' => 'tw_live_key_1234',
        'shop_domain' => 'custom-store.example.com'
    ],
    'cards_auto_top_up' => true,
    'cards_notifications' => true,
    'dispute_fighter_enabled' => true,
    'economic_intelligence_duration_key' => '7_days',
    'subscription_failure_behavior' => 'none'
  ]),
  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/accounts/{account_id}/preferences"

	payload := strings.NewReader("{\n  \"ads_certifications\": {\n    \"prescription_drug_ads\": {\n      \"status\": \"pending_information\"\n    }\n  },\n  \"ads_reporting_currency\": \"eur\",\n  \"ads_scheduling_timezone\": \"PST8PDT\",\n  \"ads_triple_whale_integration\": {\n    \"api_key\": \"tw_live_key_1234\",\n    \"shop_domain\": \"custom-store.example.com\"\n  },\n  \"cards_auto_top_up\": true,\n  \"cards_notifications\": true,\n  \"dispute_fighter_enabled\": true,\n  \"economic_intelligence_duration_key\": \"7_days\",\n  \"subscription_failure_behavior\": \"none\"\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/accounts/{account_id}/preferences")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"ads_certifications\": {\n    \"prescription_drug_ads\": {\n      \"status\": \"pending_information\"\n    }\n  },\n  \"ads_reporting_currency\": \"eur\",\n  \"ads_scheduling_timezone\": \"PST8PDT\",\n  \"ads_triple_whale_integration\": {\n    \"api_key\": \"tw_live_key_1234\",\n    \"shop_domain\": \"custom-store.example.com\"\n  },\n  \"cards_auto_top_up\": true,\n  \"cards_notifications\": true,\n  \"dispute_fighter_enabled\": true,\n  \"economic_intelligence_duration_key\": \"7_days\",\n  \"subscription_failure_behavior\": \"none\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.whop.com/api/v1/accounts/{account_id}/preferences")

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  \"ads_certifications\": {\n    \"prescription_drug_ads\": {\n      \"status\": \"pending_information\"\n    }\n  },\n  \"ads_reporting_currency\": \"eur\",\n  \"ads_scheduling_timezone\": \"PST8PDT\",\n  \"ads_triple_whale_integration\": {\n    \"api_key\": \"tw_live_key_1234\",\n    \"shop_domain\": \"custom-store.example.com\"\n  },\n  \"cards_auto_top_up\": true,\n  \"cards_notifications\": true,\n  \"dispute_fighter_enabled\": true,\n  \"economic_intelligence_duration_key\": \"7_days\",\n  \"subscription_failure_behavior\": \"none\"\n}"

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

{
  "ads_agreement": {
    "accepted_at": "2026-01-01T12:00:00.000Z",
    "agreement_version": "2026-01-01",
    "printed_name": "Marcus Webb",
    "status": "not_required"
  },
  "ads_certifications": [
    {
      "approved_countries": [
        "<string>"
      ],
      "business_name": null,
      "business_type": "online_pharmacy",
      "certification_type": "prescription_drug_ads",
      "countries": [
        "<string>"
      ],
      "denial_reason": null,
      "request_id": "inrq_xxxxxxxxxxxxxx",
      "status": "not_started",
      "url": null
    }
  ],
  "ads_payment_methods": {
    "backup": {
      "id": "ldgr_xxxxxxxxxxxxxx",
      "type": "platform_balance",
      "card_brand": "visa",
      "exp_month": 10,
      "exp_year": 2031,
      "icon_url": "https://whop-assets-example.s3.amazonaws.com/uploads/image/2026-01-01/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
      "last4": "4242",
      "title": "Shine Time Auto Detailing"
    },
    "primary": {
      "id": "ldgr_xxxxxxxxxxxxxx",
      "type": "platform_balance",
      "card_brand": "visa",
      "exp_month": 10,
      "exp_year": 2031,
      "icon_url": "https://whop-assets-example.s3.amazonaws.com/uploads/image/2026-01-01/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
      "last4": "4242",
      "title": "Shine Time Auto Detailing"
    }
  },
  "ads_reporting_currency": "usd",
  "ads_scheduling_timezone": "America/New_York",
  "ads_triple_whale_integration": {
    "masked_api_key": "tw_live_********",
    "shop_domain": "shinetime.myshopify.com",
    "status": "requires_shop_domain"
  },
  "cards_auto_top_up": false,
  "cards_notifications": true,
  "dispute_fighter_enabled": false,
  "economic_intelligence": false,
  "economic_intelligence_ends_at": "2026-01-01T12:00:00.000Z",
  "economic_intelligence_fee_percentage": 1.5,
  "economic_intelligence_offers": [
    {
      "duration": 7,
      "duration_unit": "days",
      "fee_percentage": 1,
      "key": "7_days",
      "recommended": false
    }
  ],
  "subscription_failure_behavior": "cancel"
}

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

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

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

{
  "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 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-09-29"

Path Parameters

account_id

string

required

Account ID, prefixed biz_.

Body

application/json

ads_certifications

object

Opens an advertising certification application. Keyed by certification type (prescription_drug_ads); set the entry's status to pending_information to start, then answer the requested fields via PATCH /verifications/{id}. Only one application per type can be open at a time; every other status is set by Whop's review. Requires the ad_campaign:create scope on your API key.

Show child attributes

Example:

{
  "prescription_drug_ads": { "status": "pending_information" }
}

ads_payment_methods

object

How the account pays for Whop Ads spend. Requires primary; backup is optional and covers the charge when the primary fails. Requires the ad_campaign:create scope on your API key. Configuring a card requires a user token; account API keys can configure only platform_balance sources.

Show child attributes

ads_reporting_currency

string

Lowercase ISO currency code, such as usd or eur, used to display ad spend and stats. Defaults to usd. Requires the ad_campaign:create scope on your API key.

Example:

"eur"

ads_scheduling_timezone

string

IANA timezone (e.g. America/New_York) used to interpret campaign start/end times and to bucket reports. Cannot be cleared once set — pass a new value to change it. Requires the ad_campaign:create scope on your API key.

Example:

"PST8PDT"

ads_triple_whale_integration

object

Connects or disconnects the Triple Whale integration, or changes the shop it reports to. Requires the ad_campaign:create scope on your API key. Connecting requires a shop domain to report spend against — either an explicit shop_domain (required for any merchant without a connected Shopify store, e.g. WooCommerce, a custom checkout, or a white-label platform's merchant) or a Shopify store connected on the Fulfillment page.

Show child attributes

cards_auto_top_up

boolean

Whether incoming funds are automatically moved to the account's cards balance. Requires a cards balance on the account and the payout:account:update scope on your API key.

Example:

true

cards_notifications

boolean

Whether Whop Card notifications reach this account's team. Set it to false to stop every card email and push notification for the account — application status, verification and action-required alerts, card-ready alerts, declines, large charges, and cashback summaries. Cardholder onboarding invitations still send, because they carry the only link an invited cardholder can onboard with. Requesting a card is rejected while notifications are off, since the request reaches nobody. Cards on personal accounts are unaffected. Requires a cards balance on the account and the payout:account:update scope on your API key.

Example:

true

dispute_fighter_enabled

boolean

Whether Whop assembles and files the evidence response when this account's payments are disputed. Off by default; enabling it also opts the account into the success fee charged only on disputes it wins. Requires the payment:dispute scope on your API key.

Example:

true

economic_intelligence_duration_key

enum<string>

Turns on Economic Intelligence for the duration with this key in economic_intelligence_offers, at that duration's fee. It can't be changed or turned off until economic_intelligence_ends_at, and it can only be turned on once the account is off the Economic Intelligence waitlist. Requires the company:update scope on your API key.

Available options:

7_days,

1_day,

1_hour

Example:

"7_days"

subscription_failure_behavior

enum<string>

What happens to a subscription once every retry of a renewal payment has failed. cancel (the default) cancels it. none leaves it past due and keeps billing it each period; access follows the account's past-due access setting. Requires company:manage_checkout permission.

Available options:

cancel,

none

Example:

"none"

Response

preferences updated

ads_agreement

object

required

The account's Whop Ads services and payment authorization agreement. While pending_signature, campaign launch is blocked; sign by answering requested_information via PATCH /verifications/{id}.

Show child attributes

ads_certifications

object[]

required

The account's advertising certifications, one entry per certification type Whop offers. Start an application by setting a type's status to pending_information via PATCH, then answer the fields it requests via GET/PATCH /verifications/{id}.

Show child attributes

ads_payment_methods

object | null

required

How the account pays for Whop Ads spend. primary is charged first; backup covers the charge when the primary fails. null until ads billing has been configured.

Show child attributes

ads_reporting_currency

string

required

Lowercase ISO currency code, such as usd or eur, used to display ad spend and stats. Defaults to usd.

Example:

"usd"

ads_scheduling_timezone

string

required

IANA timezone (e.g. America/New_York) used to interpret campaign start/end times and to bucket reports. Defaults to America/New_York until explicitly overridden.

Example:

"America/New_York"

ads_triple_whale_integration

object

required

The account's Triple Whale integration, which pushes Whop ad spend to Triple Whale's Data-In API so it reports as a whop channel. Available to any Triple Whale customer — Shopify, WooCommerce, a custom checkout, or no connected store — by setting shop_domain explicitly; Shopify merchants may instead rely on a connected store's domain. Requires the ad_campaign:create scope. Once connected, ad click-through URLs Whop serves carry tw_source=whop and tw_adid=<ad id> query parameters so Triple Whale's pixel attributes conversions back to the originating ad — no destination URL changes are needed.

Show child attributes

cards_auto_top_up

boolean

required

Whether incoming funds are automatically moved to the account's cards balance. false when the account has no cards balance.

Example:

false

cards_notifications

boolean

required

Whether Whop Card notifications reach this account's team. true by default, including when the account has no cards balance. Set it to false to stop every card email and push notification for the account — application status, verification and action-required alerts, card-ready alerts, declines, large charges, and cashback summaries. Cardholder onboarding invitations still send, because they carry the only link an invited cardholder can onboard with. Requesting a card is rejected while notifications are off, since the request reaches nobody. Cards on personal accounts are unaffected.

Example:

true

dispute_fighter_enabled

boolean

required

Example:

false

economic_intelligence

boolean

required

Whether Economic Intelligence is on for the account. It turns off automatically at economic_intelligence_ends_at.

Example:

false

economic_intelligence_ends_at

string | null

required

When the account's committed Economic Intelligence period ends, as an ISO 8601 timestamp. Economic Intelligence can't be turned off before then. null when Economic Intelligence is off or has no end date.

Example:

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

economic_intelligence_fee_percentage

number | null

required

Percentage of volume charged while Economic Intelligence is on, such as 1.5 for 1.5%. null when Economic Intelligence is off.

Example:

1.5

economic_intelligence_offers

object[] | null

required

Durations the account can choose from to turn on Economic Intelligence, each with its fee. null while Economic Intelligence is on or the account is still on the Economic Intelligence waitlist.

Show child attributes

subscription_failure_behavior

enum<string>

required

Available options:

cancel,

none

Example:

"cancel"