---
title: "Create a Balance Account"
method: POST
path: "/v4/profiles/{profileId}/balances"
tags: ["balance"]
---

# Create a Balance Account

`POST /v4/profiles/{profileId}/balances`

Opens a balance within the specified profile, in the currency and type specified in the request.

For `STANDARD` balances, only one can be created per currency. For `SAVINGS` balances, multiple in the same currency can be opened.

When creating a `SAVINGS` type balance, a `name` is required.

## Path parameters

- `profileId` integer, required

## Headers

- `X-idempotence-uuid` string, uuid, required
- `X-External-Correlation-Id` string, uuid

## Request body

- object — Request body for creating a balance account.
  - `currency` string, required — Currency code (ISO 4217 Alphabetic Code).
  - `type` 'STANDARD' | 'SAVINGS', required — Type of balance account. - `STANDARD` - Standard balance account. Only one per currency per profile. - `SAVINGS` - Savings balance (Jar). Multiple allowed per currency.
  - `name` string — Name of the balance. Required for SAVINGS type balances.

## Response `201`

Created - Balance successfully created.

- Balance — Represents a balance account within a profile.
  - `id` integer — Balance ID.
  - `currency` string — Currency code (ISO 4217 Alphabetic Code).
  - `type` 'STANDARD' | 'SAVINGS' — Type of balance account. - `STANDARD` - Standard balance account. Only one per currency per profile. - `SAVINGS` - Savings balance (Jar). Multiple allowed per currency.
  - `name` string, nullable — Name of the balance. Required for SAVINGS balances.
  - `icon` object, nullable — Icon for the balance.
    - `type` 'EMOJI' — Icon type.
    - `value` string — Icon value (e.g., emoji character).
  - `investmentState` 'NOT_INVESTED' | 'INVESTED' | 'INVESTING' | 'DIVESTING' | 'UNKNOWN' — Investment state of the balance. - `NOT_INVESTED` - Balance is not invested. - `INVESTED` - Balance is invested in assets. - `INVESTING` - Balance is being invested into assets. - `DIVESTING` - Balance is being divested from assets. - `UNKNOWN` - Investment state is unknown.
  - `amount` object — Available balance that can be used to fund transfers.
    - `value` number — Amount value.
    - `currency` string — Currency code (ISO 4217 Alphabetic Code).
  - `reservedAmount` object — Amount reserved for transactions.
    - `value` number — Amount value.
    - `currency` string — Currency code (ISO 4217 Alphabetic Code).
  - `cashAmount` object — Cash amount in the account.
    - `value` number — Amount value.
    - `currency` string — Currency code (ISO 4217 Alphabetic Code).
  - `totalWorth` object — Current total worth.
    - `value` number — Amount value.
    - `currency` string — Currency code (ISO 4217 Alphabetic Code).
  - `creationTime` string, date-time — Date when the balance was created.
  - `modificationTime` string, date-time — Date when the balance was last modified.
  - `visible` boolean — Whether the balance is visible to the user.

## Other responses

- `429` — Rate limit exceeded. Retry after the number of seconds specified in the `Retry-After` header.

---

[API](https://skmtc.net/wise/apis/platform-api.md) · [All operations](https://skmtc.net/wise/apis/platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/wise/platform-api/versions/4907a1d269ab/schema)