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

## Request fields (application/json):

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

  - `type` (string, required)
    Type of balance account.
    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.
    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.
    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

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

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

  - `totalWorth` (object)
    Current total worth.

  - `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