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

# Create Sub-Account API Key

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

The endpoint creates a new API key for a [sub-account](/glossary#sub-account). Each sub-account supports up to 50 API keys, independent from the main account and from other sub-accounts.

<Note>
A `type: 2` key carries deposit and withdrawal permissions, but crypto deposits must also
be enabled for the account. Deposits are disabled by default — to enable them, contact your
assigned Account Manager or email institutional@whitebit.com.
</Note>

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

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

## Request body

- object
  - `type` 1 | 2, required — Type of API key (1 - info and trading; 2 - info, trading, deposits, withdraws)
  - `subAccountId` string, required — ID of the sub-account to create the API key for
  - `title` string — Custom title/name for the API key

## Response `201`

API key created successfully

- SubAccountApiKey
  - `subAccountId` string — Sub-account identifier
  - `id` string — API key identifier
  - `title` string — API key title/name
  - `isEnabled` boolean — Whether the API key is enabled
  - `apiKey` string — API key
  - `apiSecret` string — API secret
  - `type` integer — API key type (1 - info and trading, 2 - info, trading, deposit and withdraw)
  - `lastActivity` integer — Last activity timestamp
  - `restrictAccess` boolean — Whether access is restricted
  - `accessEndpoints` object[] — List of allowed endpoints
    - `name` string — Endpoint name
    - `title` string — Endpoint title

## 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)