---
title: "Create balance configuration"
method: POST
path: "/v1/balances-config"
tags: ["Balance configurations"]
---

# Create balance configuration

`POST /v1/balances-config`

Create a balance configuration that determines how authorizations on the Pismo platform impact account balances and limits. 
To create a balance configuration, define its applicability level, filters, conditions, and results. 
For more information, refer to the [Balance configurations overview](https://developers.pismo.io/pismo-docs/docs/balances-configurations-overview) guide.

## Headers

- `x-tenant` string
- `x-cid` string

## Request body

- CreateBalancesConfig
  - `level` Level — Hierarchy level information
    - `id` string, uuid, required — Level ID generated by the [Create hierarchy](https://developers.pismo.io/pismo-docs/reference/post-hierarchies) endpoint.
    - `index` integer, required — Hierarchy level index
    - `name` string, required — Hierarchy level name
    - `description` string, required — Hierarchy level description
  - `program_id` integer — Program ID
  - `account_id` string, number — Account ID
  - `global_configs` GlobalConfig — Global configuration settings that always apply regardless of the filter.
    - `impact_parent_accounts` boolean — Indicates that the ledger should impact parent accounts also.
  - `configs` Config[] — Array of balance configurations
    - `model_id` string — Model ID configured for this organization, program, or account.

## Response `201`

Created

- object
  - `config_id` string — Balance configuration ID

## Other responses

- `400` — Bad request
- `404` — Filter template not found
- `500` — Internal server error

---

[API](https://skmtc.net/pismo/apis/platform-authentication.md) · [All operations](https://skmtc.net/pismo/apis/platform-authentication/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pismo/platform-authentication/revisions/935b62e16de4/schema)