v1

latestOpenAPI 3.1.0Copyright Pismo2026-07-247702,7523.1 MB

Balance configurations

Create balance configuration

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

post/v1/balances-config

Headers

x-tenantstring

Organization ID

x-cidstring

The Correlation Identifier field is used to link related API requests and events. The x-cid can help the Pismo engineering team track everything related to a call. You can find the x-cid field in the response header of an API endpoint call. If the x-cid value isn't passed, one is automatically generated.

Request body

program_idinteger

Program ID

account_idstring number

Account ID

Example request

{
  "level": {
    "id": "9bb95e15-c0e6-4c84-b644-350c76a83358",
    "index": 2
  },
  "program_id": 1122,
  "account_id": "15001",
  "global_configs": {
    "impact_parent_accounts": true
  },
  "configs": [
    {
      "model_id": "b3f53d8f-6812-4869-b17a-874d78750cc6"
    }
  ]
}

Response

Created

config_idstring

Balance configuration ID

Example response

{
  "config_id": "041ee495-268a-4267-b53a-5b9532a53e45"
}