Sign in
Accounts

Create Account

Creates an account. User tokens create business accounts; business account API keys create connected accounts. Tax fields (tax_remitted_by, tax_type, product_tax_code_id, business_address, tax_identifiers) are configured with Update Account, not at creation.

post/accounts

Headers

Idempotency-Keystring
Example:d9105228-4a08-46b1-8b91-42fed586d383

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

Request body

countrystring

The ISO 3166-1 alpha-2 country code where the account's business is located (e.g. US). Defaults to the parent account's country for connected accounts.

emailstring

The email address of the account owner. Required for business account API key requests.

metadataobject

Arbitrary key/value metadata to store on the account.

titlestring

The display name of the account. Defaults to metadata.external_id or the owner's email when omitted.

Response

account created

banner_image_urlstring nullable required

Account banner image URL.

business_addressobject nullable required

Account business address used to calculate tax, with line1, line2, city, state, postal_code, and country. null when no address is set.

business_typestring nullable required

High-level business category for the account. See the business types and industries glossary for valid values.

collect_vat_idboolean required

Whether checkout shows a VAT/tax ID field for buyers to optionally enter. Does not require a VAT ID to purchase.

countrystring nullable required

Country where the account is located.

created_atstring required

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

descriptionstring nullable required

Account promotional description.

emailstring nullable required

Account owner email address.

home_preferencesstring[] required
idstring required

Account ID, prefixed biz_.

industry_groupstring nullable required

Account industry group. See the business types and industries glossary for valid values.

industry_typestring nullable required

Specific industry vertical for the account. See the business types and industries glossary for valid values.

invoice_prefixstring nullable required

Prefix used for account invoices.

logo_urlstring nullable required

Account logo image URL.

metadataobject required

Arbitrary key/value metadata supplied at account creation.

onboarding_typestring nullable required

Type of onboarding the account has completed.

opengraph_image_urlstring nullable required

Account Open Graph image URL.

opengraph_image_variantstring nullable required

Account Open Graph image variant.

other_business_descriptionstring nullable required

Business type details when business_type is other.

other_industry_descriptionstring nullable required

Industry details when industry_type is other.

parent_account_idstring nullable required

Parent account ID for connected accounts.

product_tax_codeobject nullable required

Tax classification code applied by default to the account's products, with id, name, and product_type. null when no default is set.

require_2faboolean required

Whether authorized users must enable two-factor authentication.

routestring required

Account public route identifier.

send_customer_emailsboolean required

Whether Whop sends transactional emails to customers on behalf of this account.

show_joined_whopsboolean required

Whether the account appears in joined whops on other accounts.

show_reviews_dtcboolean required

Whether reviews are displayed on direct-to-consumer product pages.

show_user_directoryboolean required

Whether the account shows users in the user directory.

statusstring nullable required

Whether the account can operate on Whop: active or suspended. Computed only on retrieve and me; null otherwise.

store_page_configobject required

Account store page display configuration.

target_audiencestring nullable required

Target audience for this account.

tax_collection_enabled_statesstring[] required
tax_remitted_bystring nullable required

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.

tax_typestring nullable required

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.

titlestring required

Account display name.

total_earned_usdnumber nullable required

Account lifetime sales, normalized to USD. Computed only on retrieve and me for callers with stats:read scope; null otherwise.

total_usdstring nullable required

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.

use_logo_as_opengraph_image_fallbackboolean required

Whether the account uses its logo as the fallback Open Graph image.

verificationobject required

Account identity verification status for the individual (KYC) and business (KYB) profiles. Each is null until created, otherwise a status of not_started, pending, approved, or rejected.

Example response

{
  "capabilities": {
    "accept_bank_payments": "active",
    "accept_bnpl_payments": "active",
    "accept_card_payments": "active",
    "bank_deposit": "active",
    "card_deposit": "active",
    "card_issuing": "active",
    "crypto_deposit": "active",
    "crypto_payout": "active",
    "instant_payout": "active",
    "run_ads": "active",
    "standard_payout": "active",
    "transfer": "active"
  },
  "cards": {
    "kind": "individual"
  },
  "company_formation": {
    "signatures": {
      "form8821": {
        "status": "pending"
      },
      "ss4": {
        "status": "pending"
      }
    }
  },
  "recommended_actions": [
    {
      "action": "theme_business",
      "status": "optional"
    }
  ],
  "required_actions": [
    {
      "action": "deposit_funds",
      "status": "required"
    }
  ],
  "social_links": [
    {
      "website": "x"
    }
  ],
  "wallet": {
    "network": "solana"
  }
}

Changes