# Create a wallet (/docs/api-reference/wallets/create)

`POST /v1/wallets`

Creates an empty wallet in a currency the partner has no wallet in yet.

Take `currencyId` from `GET currencies`. The new wallet starts with a zero balance. Without a
`label` it is named after its currency, for example `USD wallet`. The partner's first wallet is
always selected; for a later one, `isSelected: true` makes it the selected wallet in place of the
current one. Returns `201` without a body; list the wallets to read it.
            
A second wallet in the same currency returns `400` with code `17000`
(`WALLET_CURRENCY_ALREADY_EXISTS`); a label already used by another of the partner's wallets,
ignoring case, returns `400` with code `17001` (`WALLET_LABEL_ALREADY_EXISTS`).

## Request body

- `application/json`: `WalletCreateRequest`
- `text/json`: `WalletCreateRequest`
- `application/*+json`: `WalletCreateRequest`

## Responses

### 201

Created

### 400

Invalid partner request or model validation failure.

- `application/json`: `ErrorResponse`

### 401

Unauthorized

- `text/plain`: `ErrorResponse`
- `application/json`: `ErrorResponse`
- `text/json`: `ErrorResponse`

### 403

Forbidden

- `text/plain`: `ErrorResponse`
- `application/json`: `ErrorResponse`
- `text/json`: `ErrorResponse`

### 429

Too many requests from this IP address. Wait for Retry-After seconds, then send the same request again; an order keeps its Idempotency-Key and body.

- `application/json`: `ErrorResponse`

The full schemas are in the OpenAPI specification at /openapi.json.