Update Account Preferences
Updates the account’s preferences. Each top-level key in the body replaces its stored value as a whole. Keys left out keep their current values.
The required scope depends on which preferences you update.
ad_campaign:create:ads_payment_methods,ads_reporting_currency,ads_scheduling_timezone,ads_triple_whale_integration.payout:account:update:cards_auto_top_up,cards_notifications,covers_subaccount_negative_balances,merchant_of_record.payment:dispute:dispute_fighter_enabled.company:update:economic_intelligence_duration_key,economic_intelligence_auto_renew,review_request_emails,cancellation_emails,renewal_reminder_emails,failed_payment_emails,subaccount_notifications,subaccount_team_view_only.company:manage_checkout:feedback_options,customer_tracking.
To update keys under more than one scope, the API key needs all of those scopes.
Autorisaties
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.
Body
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.
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.
true
Whether this account covers its subaccounts' negative balances. When a subaccount's balance drops below zero (from refunds, disputes, or fees), this account's available balance in the same currency pays it back, up to what is available. Only accounts with subaccounts can set it. Requires the payout:account:update scope on your API key.
true
false stops renewing: Economic Intelligence stays on until the end of the current period, and the fee is charged until then. true keeps it renewing again before then, or turns it on like the 3_days offer. Can't be combined with economic_intelligence_duration_key. Requires the company:update scope on your API key.
false
Turns on Economic Intelligence with the offer that has this key in economic_intelligence_offers, at that offer's fee. Only 3_days, the auto-renew offer, is accepted. Any other key is rejected. Returns 403 for an account Economic Intelligence is not offered to. Requires the company:update scope on your API key.
3_days, weekly, 7_days, 1_day, 1_hour "3_days"
Whether Whop emails members when a renewal payment fails or needs them to verify it. Set it to false to stop these emails while keeping the account's other customer emails. Subscriptions billed by invoice still get their invoice emails. Requires the company:update scope on your API key.
false
Replaces the account's own cancel reasons, shown to members in this order when they cancel. Pass an option's id to keep it, for example when renaming it; options without an id are added, and options left out are removed. Pass an empty array to go back to Whop's default reasons. Members who already picked an option keep the label they saw. Requires the company:manage_checkout scope on your API key.
10Set it to account to make the account the merchant of record. Only some business categories can switch. The business must be verified. The switch cannot be undone. The response shows pending until approval. Checkout takes no payments until then. After the switch, the account accepts only card, Apple Pay, Google Pay and crypto payments. PayPal, buy now pay later and local payment methods stop. Requires the payout:account:update scope on your API key.
account "account"
Settle every new sale into this currency, regardless of the plan's currency or what the buyer paid in; sales converted this way carry an additional 0.5% FX fee. Pass null to go back to settling each sale in its plan's currency. Changing it never converts money already in your balances, and it can change at most once a day (see preferred_settlement_currency_changeable_at). Requires the payout:account:update scope on your API key.
usd, eur, gbp, cad, aud, null "eur"
Whether Whop emails and notifies the teams of this account's subaccounts. Set it to false to stop Whop's emails, push, and in-app notifications to them. These include payout, verification, dispute, and card alerts about their accounts. Only accounts with subaccounts can set it. Requires the company:update scope on your API key.
true
Whether this account's subaccounts are view-only for their own team members. Set it to true to refuse every change a subaccount's team tries to make while still letting them see what their role allows. Only accounts with subaccounts can set it. Requires the company:update scope on your API key.
true
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.
cancel, none "none"
Respons
preferences updated
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, or a custom checkout — by setting shop_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.
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.
true
Whether this account covers its subaccounts' negative balances. When a subaccount's balance drops below zero (from refunds, disputes, or fees), this account's available balance in the same currency pays it back, up to what is available. Refunds on its subaccounts may also take them negative by up to this account's available balance. null when the account has no subaccounts.
false
Whether Economic Intelligence renews itself every period, with no end date. Turn it on by setting this to true, or by passing the 3_days offer's key as economic_intelligence_duration_key. Set it to false to stop renewing: Economic Intelligence stays on until the end of the current period, shown in economic_intelligence_ends_at, and the fee is charged until then. Set it back to true before then to keep renewing.
false
Whether Whop emails members when a renewal payment fails or needs them to verify it. true by default. Set it to false to stop these emails while keeping the account's other customer emails. Subscriptions billed by invoice still get the invoice and its past-due reminders, since that is how the member pays. These emails also stop while the account's send_customer_emails is false.
true
The merchant of record for the account's payments. whop means Whop is the merchant of record and the account can switch. null means Whop is the merchant of record and the account's business category cannot switch. pending means the account switched and waits for approval. Checkout takes no payments until then. account means the account is the merchant of record.
whop, pending, account, null "whop"
Lowercase ISO currency code every new sale settles into, regardless of the plan's currency or what the buyer paid in. Sales converted this way carry an additional 0.5% FX fee. null when the account settles each sale in its plan's currency.
usd, eur, gbp, cad, aud, null "eur"
Whether Whop emails members the day before their membership renews or their free trial converts. true by default. Set it to false to stop that reminder. Members still get the reminders card networks require. They go out 7 days before a trial over 7 days converts, and 30 days before a 6-month or longer plan renews. All stop while send_customer_emails is false.
true
Whether Whop emails and notifies the teams of this account's subaccounts. true by default. Set it to false to stop Whop's emails, push, and in-app notifications to them. These include payout, verification, dispute, and card alerts about their accounts. null when the account has no subaccounts.
true
Whether this account's subaccounts are view-only for their own team members. When true, a subaccount's team can still see everything their role allows but every change is refused with a view-only error. false by default. null when the account has no subaccounts.
false
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.
cancel, none "cancel"

