Create Account
Creates an account. User tokens create business accounts; Account API keys create subaccounts. Tax fields (tax_remitted_by, tax_type, product_tax_code_id, business_address, tax_identifiers) are configured with Update Account, not at creation.
Autorisations
An Account API key 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.
En-têtes
A unique key that makes this request safe to retry. See Idempotent requests.
255"d9105228-4a08-46b1-8b91-42fed586d383"
Corps
Your platform's own identifier for this subaccount, such as your user or store ID. Unique among your subaccounts: creating a second account with the same external_id and a different email returns a 409, unless reassign_external_id is true. Retrying with the same email and external_id returns the existing account. Subaccounts only.
1 - 255"user_12345"
Arbitrary key/value metadata to store on the account. When external_id is not sent, an external_id key here sets external_id and follows its rules. It must be unique among your subaccounts unless reassign_external_id is true. It stays in metadata as sent. Changing it later does not change external_id.
Pass true to move external_id to the new subaccount when another of your subaccounts already has it. Without it, that request returns a 409. The subaccount that had it is not deleted. It stays active with external_id set to null, and its metadata is unchanged. Requires external_id. Also requires the company:update permission on your platform account, in addition to company:create_child. Ignored when the same email already has the external_id, which returns that account.
false
Réponse
account created
High-level business category for the account. See the business types and industries glossary for valid values.
"software"
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.
When a suspended account can pay out its balance to its own payout method, as an ISO 8601 timestamp. A dispute can move it later. Computed on retrieve, me, and suspend; null otherwise, when status is not suspended, and when the suspension holds the balance.
null
Specific industry vertical for the account. See the business types and industries glossary for valid values.
"trading"
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 means Whop calculates and remits. self means Whop calculates, and the account collects and remits. none means neither, and the account is responsible. New businesses start on whop, and new connected accounts start on none. null means the account has no setting yet.
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"
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"

