# Create a Balance Account

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.

Endpoint: POST /v4/profiles/{profileId}/balances
Security: UserToken, PersonalToken

## Path parameters:

  - `profileId` (integer, required)
    The profile ID.

## Header parameters:

  - `X-idempotence-uuid` (string, required)
    Unique identifier assigned by you. Used for idempotency check purposes. Should your call fail for technical reasons then you can use the same value again for making a retry call.

  - `X-External-Correlation-Id` (string)
    Optional UUID for correlating requests across systems. If provided, Wise echoes it back in the response. Maximum 36 characters. Learn more.
    Example: "f47ac10b-58cc-4372-a567-0e02b2c3d479"

## Request fields (application/json):

  - `currency` (string, required)
    Currency code (ISO 4217 Alphabetic Code).
    Example: "EUR"

  - `type` (string, required)
    Type of balance account.
- STANDARD - Standard balance account. Only one per currency per profile.
- SAVINGS - Savings balance (Jar). Multiple allowed per currency.
    Enum: "STANDARD", "SAVINGS"

  - `name` (string)
    Name of the balance. Required for SAVINGS type balances.

## Response 201 fields (application/json):

  - `id` (integer)
    Balance ID.
    Example: 200001

  - `currency` (string)
    Currency code (ISO 4217 Alphabetic Code).
    Example: "EUR"

  - `type` (string)
    Type of balance account.
- STANDARD - Standard balance account. Only one per currency per profile.
- SAVINGS - Savings balance (Jar). Multiple allowed per currency.
    Enum: "STANDARD", "SAVINGS"

  - `name` (string,null)
    Name of the balance. Required for SAVINGS balances.

  - `icon` (object,null)
    Icon for the balance.

  - `icon.type` (string)
    Icon type.
    Enum: "EMOJI"

  - `icon.value` (string)
    Icon value (e.g., emoji character).

  - `investmentState` (string)
    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.
    Enum: "NOT_INVESTED", "INVESTED", "INVESTING", "DIVESTING", "UNKNOWN"

  - `amount` (object)
    Available balance that can be used to fund transfers.

  - `amount.value` (number)
    Amount value.
    Example: 310.86

  - `amount.currency` (string)
    Currency code (ISO 4217 Alphabetic Code).
    Example: "EUR"

  - `reservedAmount` (object)
    Amount reserved for transactions.

  - `reservedAmount.value` (number)
    Amount value.

  - `reservedAmount.currency` (string)
    Currency code (ISO 4217 Alphabetic Code).
    Example: "EUR"

  - `cashAmount` (object)
    Cash amount in the account.

  - `cashAmount.value` (number)
    Amount value.
    Example: 310.86

  - `cashAmount.currency` (string)
    Currency code (ISO 4217 Alphabetic Code).
    Example: "EUR"

  - `totalWorth` (object)
    Current total worth.

  - `totalWorth.value` (number)
    Amount value.
    Example: 310.86

  - `totalWorth.currency` (string)
    Currency code (ISO 4217 Alphabetic Code).
    Example: "EUR"

  - `creationTime` (string)
    Date when the balance was created.
    Example: "2020-05-20T14:43:16.658Z"

  - `modificationTime` (string)
    Date when the balance was last modified.
    Example: "2020-05-20T14:43:16.658Z"

  - `visible` (boolean)
    Whether the balance is visible to the user.
    Example: true