---
title: "Create customer balance transaction"
method: POST
path: "/customers/{customer_id}/balance_transactions"
tags: ["Customer"]
---

# Create customer balance transaction

`POST /customers/{customer_id}/balance_transactions`

Creates an immutable balance transaction that updates the customer's balance and returns back the newly created
transaction.

## Path parameters

- `customer_id` string, required

## Request body

- NewCustomerBalanceTransaction
  - `amount` string, required
  - `type` 'increment' | 'decrement', required
  - `description` string, nullable — An optional description that can be specified around this entry.

## Response `200`

OK

- CustomerBalanceTransaction
  - `id` string, required — A unique id for this transaction.
  - `created_at` string, date-time, required — The creation time of this transaction.
  - `starting_balance` string, required — The original value of the customer's balance prior to the transaction, in the customer's currency.
  - `ending_balance` string, required — The new value of the customer's balance prior to the transaction, in the customer's currency.
  - `amount` string, required — The value of the amount changed in the transaction.
  - `action` 'applied_to_invoice' | 'manual_adjustment' | 'prorated_refund' | 'revert_prorated_refund' | 'return_from_voiding' | 'credit_note_applied' | 'credit_note_voided' | 'overpayment_refund' | 'external_payment' | 'small_invoice_carryover', required
  - `description` string, nullable, required — An optional description provided for manual customer balance adjustments.
  - `invoice` InvoiceTiny, required
    - `id` string, required — The Invoice id
  - `type` 'increment' | 'decrement', required
  - `credit_note` CreditNoteTiny, required
    - `id` string, required — The id of the Credit note

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `409` — Conflict
- `413` — Content Too Large
- `429` — Too Many Requests
- `500` — Internal Server Error

---

[API](https://skmtc.net/withorb/apis/api-reference.md) · [All operations](https://skmtc.net/withorb/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/withorb/api-reference/versions/816dfe734e2e/schema)