Skip to main content
POST
Create account

Authorizations

Authorization
string
header
required

JWT issued by POST /api/v1.1/access-token/b2b. Send Authorization: Bearer <token>.

X-PARTNER-ID
string
header
required

Merchant API key (Credential.api_key). Required on every request.

Body

application/json
name
string
required
Required string length: 3 - 100
Example:

"John Doe"

account_type
enum<string>
required

Required. Sub account type. owned/personal_managed create the account active immediately (no KYB). business_managed creates the account inactive and requires BOSS KYB approval before the account can transact.

Available options:
owned,
personal_managed,
business_managed
Example:

"owned"

invite_members
string<email>[] | null

Optional. Array of additional merchant member email addresses to grant access to this account, on top of the calling merchant's own primary dashboard login (always granted access automatically, whether or not this field is provided). All emails must belong to registered members of the merchant. If omitted, only the primary merchant has access.

Maximum array length: 50
Example:

Response

Account created

status
integer
required
Example:

200

success
boolean
required
Example:

true

data
object
required