Update Account
Updates an account. User tokens can update business accounts; Account API keys can update connected accounts. The reserved id me — accepted on Retrieve Account — resolves to the requesting account, which an Account API key cannot edit, so updates must name the connected account by its biz_ id.
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
Pins the request to a dated API version.
"2026-09-15"
Path Parameters
Account ID, prefixed biz_.
Body
Whether prospective affiliates must submit an application before promoting this account.
true
Guidelines shown to affiliates promoting this account.
"Send us your detailing content before promoting. No paid search on our brand terms."
Account banner image, used as the cover photo when creating a Whop-managed Facebook page. Image files up to 10 MB, except image/gif. Pass a JSON object containing an id from Create File.
Account business address used to calculate tax. A complete address in a supported country is required when tax_remitted_by is self.
The legal business name used with the account's tax address.
255" Shine Time Auto Detailing, LLC "
High-level business category for the account. See the business types and industries glossary for valid values.
"other"
Whether checkout shows a VAT/tax ID field for buyers to optionally enter. Does not require a VAT ID to purchase.
true
Country where the account is located.
"US"
Account promotional description. When creating a Whop-managed Facebook page, it is truncated to 155 characters and used as the About text.
"Mobile ceramic coating, paint correction, and interior detailing across the Austin metro."
The ID of the product to feature for affiliates. Pass null to clear.
"prod_xxxxxxxxxxxxxx"
Public account home page preferences.
hide_member_count, hide_members_card Account industry group. See the business types and industries glossary for valid values.
"automotive"
Specific industry vertical for the account. See the business types and industries glossary for valid values.
"other"
Prefix used for account invoices.
"SHINE"
Account logo, used as the profile picture when creating a Whop-managed Facebook page. Image files up to 5 MB. Pass a JSON object containing an id from Create File.
Arbitrary key/value metadata to store on the account.
The type of onboarding the account has completed.
platform, seller, null "seller"
Open Graph preview media used when the account is shared. Image and video files up to 5 MB. Pass a JSON object containing an id from Create File.
The account Open Graph image variant.
white, black, orange, null "black"
The description of the business type when business_type is other.
"Mobile auto detailing"
The description of the industry type when industry_type is other.
"Automotive services"
ID of the tax classification code applied by default to the account's products. See the available product categories.
"ptc_xxxxxxxxxxxxxx"
Whether the account requires authorized users to have two-factor authentication enabled.
true
The unique URL slug for the account.
"shine-time-detailing"
Whether Whop sends transactional emails to customers on behalf of this account.
false
Whether the account appears in joined whops on other accounts.
false
Whether reviews are displayed on direct-to-consumer product pages.
false
Whether the account shows users in the user directory.
false
The full list of social links to display for the account.
Account store page display configuration.
The target audience for this account.
"Owners of new and enthusiast vehicles in Austin, TX"
US state codes (50 states plus DC) where the account collects tax. Replaces the full set on update. Only settable when tax_remitted_by is self.
AL, AK, AZ, AR, CA, CO, CT, DE, DC, FL, GA, HI, ID, IL, IN, IA, KS, KY, LA, ME, MD, MA, MI, MN, MS, MO, MT, NE, NV, NH, NJ, NM, NY, NC, ND, OH, OK, OR, PA, RI, SC, SD, TN, TX, UT, VT, VA, WA, WV, WI, WY Account tax/VAT registrations to add or update. When tax_remitted_by is self, tax is calculated and collected only in the countries where the account holds a registration.
Determines whether Whop or the account calculates and remits tax. The account must provide a supported-country business address when it self-remits.
whop, self, none "self"
Determines whether tax is included in the listed price or added at checkout.
inclusive, exclusive "inclusive"
3D Secure behavior for supported on-session card payments. mandate_challenge requires a 3DS challenge before payment processing; mandate_if_required mandates a challenge only when the payment processor requires it; frictionless_if_required uses the regular frictionless 3DS flow. Payments of $1,000 or more use mandate_if_required unless mandate_challenge is selected. Risk and authentication recovery requirements can override the preference. null uses the standard checkout flow.
mandate_challenge, mandate_if_required, frictionless_if_required, null "mandate_challenge"
The display name of the account.
"Shine Time Auto Detailing"
Whether the account uses its logo as the fallback Open Graph image.
true
The account's business website, as an http or https URL of at most 255 characters. Also added to the account's social_links as a website entry. Pass null to clear the website; existing social links are left unchanged.
"https://shinetimedetail.com"
Response
account updated
Account banner image URL.
"https://whop-assets-example.s3.amazonaws.com/uploads/image/2026-01-01/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
Account business address used to calculate tax, with line1, line2, city, state, postal_code, and country. null when no address is set.
The account's legal business name used with its tax address.
255"Shine Time Auto Detailing, LLC"
High-level business category for the account. See the business types and industries glossary for valid values.
"other"
Whether pending funds may be transferred from this platform account to its connected accounts.
false
Payment rails enabled for this account, each active, inactive, or pending (onboarding or review in progress). Computed only on retrieve and me for callers with company:balance:read scope; null otherwise.
Whop Cards application details for the account. Computed only on retrieve and me for callers with company:balance:read scope; null otherwise, or when the account has no card application.
Whether checkout shows a VAT/tax ID field for buyers to optionally enter. Does not require a VAT ID to purchase.
true
Company formation state for the account, managed through Form Company. A draft status until the formation checkout is paid, then filing progress with downloadable documents and signatures awaiting action. Empty when the formation state is temporarily unavailable.
Country where the account is located.
"us"
When the account was created, as an ISO 8601 timestamp.
"2026-01-01T12:00:00.000Z"
Account promotional description.
"Mobile ceramic coating, paint correction, and interior detailing across the Austin metro."
Whether economic intelligence is enabled for the account.
false
Account owner email address.
"marcus@shinetime.example"
The account's end-user license agreement document, or null if they have not published one.
Public account home page preferences.
hide_member_count, hide_members_card Account ID, prefixed biz_.
"biz_xxxxxxxxxxxxxx"
Account industry group. See the business types and industries glossary for valid values.
"automotive"
Specific industry vertical for the account. See the business types and industries glossary for valid values.
"other"
Prefix used for account invoices.
"SHINE"
Account logo image URL.
"https://whop-assets-example.s3.amazonaws.com/uploads/image/2026-01-01/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
Arbitrary key/value metadata supplied at account creation.
Type of onboarding the account has completed.
platform, seller, null "seller"
Account Open Graph image URL.
"https://whop-assets-example.s3.amazonaws.com/uploads/image/2026-01-01/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
Account Open Graph image variant.
white, black, orange, null "black"
Business type details when business_type is other.
"Mobile auto detailing"
Industry details when industry_type is other.
"Automotive services"
The single user who owns the account, whose email is the email above. Distinct from the owner role on team members, which any number of them can hold.
Parent account for connected accounts, or null for standalone accounts.
Payment health controls currently applied to the account. Computed only on retrieve and me for callers with company:balance:read scope; null otherwise.
The account's privacy policy document, or null if they have not published one.
Tax classification code applied by default to the account's products, with id, name, and product_type. null when no default is set.
DEPRECATED: Use the GET /economic_intelligence?account_id={account_id} endpoint instead.
Whether authorized users must enable two-factor authentication.
true
The account's return policy document, or null if they have not published one.
Account public route identifier.
"biz_xxxxxxxxxxxxxx"
Whether Whop sends transactional emails to customers on behalf of this account.
false
Whether the account appears in joined whops on other accounts.
false
Whether reviews are displayed on direct-to-consumer product pages.
false
Whether the account shows users in the user directory.
false
Whether the account settles on stablecoin rails — its balance is held on-chain as USDT and paid out over crypto, rather than as fiat cash.
false
Whether the account can operate on Whop: active or suspended. Computed on list, retrieve, me, and suspend; null otherwise.
"active"
Why the account was suspended, in language safe to show the account owner. Computed on retrieve, me, and suspend; null otherwise, when status is not suspended, and when the suspension was recorded without a reason.
"Payments are paused while we review recent chargebacks on this account."
Account store page display configuration.
Target audience for this account.
"Owners of new and enthusiast vehicles in Austin, TX"
US state codes (of the 50 states plus DC) where the account collects tax: the full set when Whop remits (tax_remitted_by whop), the configured subset when the account self-remits (self), and empty when neither. On update, send the complete list to replace it (only allowed when self).
Who calculates and remits tax for the account: whop (Whop calculates and remits), self (Whop calculates; the account collects and remits), or none (neither; the account is responsible). null until the account enrolls in the Whop tax service.
whop, self, none, null "self"
How tax is applied to the account's prices: inclusive (tax included in the listed price) or exclusive (tax added on top). Defaults to exclusive when unset; null only when the account has no payment connection.
inclusive, exclusive, null "inclusive"
The account's terms of service document, or null if they have not published one.
3D Secure behavior for supported on-session card payments. mandate_challenge requires a 3DS challenge before payment processing; mandate_if_required mandates a challenge only when the payment processor requires it; frictionless_if_required uses the regular frictionless 3DS flow. Payments of $1,000 or more use mandate_if_required unless mandate_challenge is selected. Risk and authentication recovery requirements can override the preference. null uses the standard checkout flow.
mandate_challenge, mandate_if_required, frictionless_if_required, null "mandate_challenge"
Account display name.
"Shine Time Auto Detailing"
Account lifetime sales, normalized to USD. Computed only on retrieve and me for callers with stats:read scope; null otherwise.
0
Total USD value across balances with known exchange rates. Computed only on single-account reads (retrieve and me); null on list responses, writes, missing balance-read permission, or unavailable balance source.
"50.00"
Whether the account uses its logo as the fallback Open Graph image.
true
Account identity verification status for the individual (KYC) and business (KYB) profiles. Each is null until created, otherwise a status of not_started, pending, manual_review, approved, or rejected.
Lifetime volume through the account — sales plus transfers received — normalized to USD. Computed only on list for callers with stats:read on the account; null otherwise.
Account primary crypto wallet, or null if none has been provisioned.
The account's business website URL, or null if none has been provided. Setting it also adds a website entry to social_links.
"https://shinetimedetail.com"
The account's active first-tier partner. Present on retrieve responses; null when no active first-tier partner is attributed to the account. Omitted from other responses.