---
title: "Create Sub-Account"
method: POST
path: "/api/v4/sub-account/create"
tags: ["Sub-Account"]
---

# Create Sub-Account

`POST /api/v4/sub-account/create`

The endpoint creates new [sub-account](/glossary#sub-account).

<Note>
The `email` field requirement depends on the `shareKyc` parameter:
- When `shareKyc` is `false` or not provided: `email` is **required**
- When `shareKyc` is `true`: `email` is **optional**
</Note>

<Note>
Crypto deposits are disabled by default. Once deposits are enabled for the account, the
capability applies to the account and its sub-accounts; enablement is not available via
API. To request it, contact your assigned Account Manager or email institutional@whitebit.com.
Once enabled, a sub-account generates deposit addresses through the standard
[deposit-address endpoint](/api-reference/account-wallet/get-cryptocurrency-deposit-address)
using its own API key with deposit permission.
</Note>

<Warning>
Rate limit: 1000 requests/10 sec.
</Warning>

<Note>
The API does not cache the response.
</Note>

## Request body

- object
  - `alias` string, required — Name for sub-account
  - `email` string — Sub-account email (required when shareKyc is false)
  - `shareKyc` boolean — If KYC shared with main account
  - `permissions` object, required
    - `spotEnabled` boolean, required — Enable transfers to trade balance
    - `collateralEnabled` boolean, required — Enable transfers to collateral balance

## Response `201`

Sub-account created successfully

- SubAccount
  - `id` string — Sub-account identifier
  - `alias` string — Sub-account alias/name
  - `userId` string — User identifier associated with account
  - `email` string — Sub-account email (masked)
  - `status` string — Sub-account status
  - `color` string — Sub-account color
  - `kyc` object — KYC information
    - `shareKyc` boolean — Whether KYC is shared with main account
    - `kycStatus` string — KYC status
  - `permissions` object — Sub-account permissions
    - `spotEnabled` boolean — Spot trading enabled
    - `collateralEnabled` boolean — Collateral trading enabled

## Other responses

- `400` — Request validation failed

---

[API](https://skmtc.net/whitebit/apis/whitebit-private-http-api-v4.md) · [All operations](https://skmtc.net/whitebit/apis/whitebit-private-http-api-v4/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/whitebit/whitebit-private-http-api-v4/revisions/76c9def9942f/schema)