---
title: "Create Ledger"
method: POST
path: "/v2/clients/{ClientID}/ledgers"
tags: ["Ledger"]
---

# Create Ledger

`POST /v2/clients/{ClientID}/ledgers`

Creates a ledger.  

 Request to enable at [TabaPay Support](https://tabapay.zendesk.com/hc/en-us/requests/new#/) or [help@tabapay.com](mailto:help@tabapay.com)

## Path parameters

- `ClientID` string, required

## Request body

- LedgerCreate
  - `referenceID` string, required — Client-defined reference identifier
  - `userID` string, required — TabaPay user identifier
  - `bank` string, required — Ledger backing bank identifier
  - `type` 'BalanceHolding' | 'Passthrough', required
  - `currency` string, required — ISO-4217 numeric currency code

## Response `200`

Ledger created.

- CreateLedgerResponse
  - `SC` integer — [HTTP Status Code](https://developers.tabapay.com/reference/http-status-codes#/)
  - `EC` string — Internal Error Code. This is used to help TabaPay team members trace an error.
  - `EM` string — Short description of the error if an error occurred.
  - `ledgerID` string — TabaPay ledger identifier

## Other responses

- `207` — One or more failures occurred while processing the Request.

---

[API](https://skmtc.dev/tabapay/apis/tabapay-apis.md) · [All operations](https://skmtc.dev/tabapay/apis/tabapay-apis/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/tabapay/tabapay-apis/revisions/154fa3d585cf/schema)