Skip to main content
POST
A platform customer uses one account per end customer. This call creates that account and stores the end customer’s identity profile on it. For a business, you can add its associated persons in the same call. Only platform customers can create accounts. For any other customer the endpoint returns 404. Creating an account does not start virtual account onboarding. Open a group afterwards with Create Virtual Account Group. Requires an API key with write access on the accounts scope.

​
Path Parameters

​
string
required
Your customer’s external ID (starts with cus_)

​
Headers

​
string
required
A UUID for this account. Scoped to your customer: a key you have used before returns the account it created with 200, and the request body is not compared, so a replay with different details still returns the original account. Use a new key for each new account. See Idempotency.

​
Request Body

The body is the account’s identity profile, with the same fields as Update Account. Every field that Update Account marks as required on the first call is required here.
​
string
required
Entity type: business or individual. It selects the field group, and cannot be changed later.
​
object
required
The business or individual fields for the chosen type, as documented on Update Account. Unknown keys are rejected with 422 VALIDATION_ERROR.
​
object[]
Business accounts only. The people behind the entity, such as owners, directors and signers, each with the same body as Create Associated Person. Include at least one person with is_signer: true so the business can sign its agreements. You can also add people later.They are stored as separate resources. Read them with List Associated Persons.

​
Response

Returns 201 with the new account, in the same shape as Get Account. The stored profile is in profile, and status is active. A replayed Idempotency-Key returns 200 with the account it created. A new account also sends an account.created webhook to any endpoint subscribed to it.

​
Errors

​
Next steps

Open a group for the account with Create Virtual Account Group, then clear its requirements as described in Virtual Account Onboarding. To correct the identity later, use Update Account.