---
title: "Create Ledger Account"
method: POST
path: "/ledger_accounts"
---

# Create Ledger Account

`POST /ledger_accounts`

## Request body

- object
  - `name` string, required — The name of the ledger account. Maximum of 1000 characters allowed.
  - `description` string — An optional free-form description for internal use. Maximum of 1000 characters allowed.
  - `currency` string, required
  - `currency_exponent` integer — Must be included if currency is a [custom currency](https://docs.moderntreasury.com/platform/docs/currencies). The currency_exponent cannot exceed 30.
  - `normal_balance` string, required — One of `credit`, `debit`
  - `ledger_id` string, required
  - `ledgerable_id` string — The id of linked ledgerable
  - `ledgerable_type` string — The type of linked ledgerable. See [Ledger Accounts](https://docs.moderntreasury.com/platform/reference/ledger-account-object) for list of types
  - `metadata` string, json — Metadata to be added to the ledger account. Must be a JSON object.
  - `ledger_account_category_ids` string[] — The array of parent ledger account category IDs to which this ledger account will be associated on creation. This is performed atomically, and all associations must be valid and succeed for the ledger account to be successfully created.
  - `external_id` string — An optional user-defined 180 character unique identifier

## Response `201`

201

- object
  - `id` string
  - `object` string
  - `live_mode` boolean
  - `name` string
  - `ledger_id` string
  - `description` unknown
  - `lock_version` integer
  - `normal_balance` string
  - `balances` object
    - `effective_at_lower_bound` unknown
    - `effective_at_upper_bound` unknown
    - `pending_balance` object
      - `credits` integer
      - `debits` integer
      - `amount` integer
      - `currency` string
      - `currency_exponent` integer
    - `posted_balance` object
      - `credits` integer
      - `debits` integer
      - `amount` integer
      - `currency` string
      - `currency_exponent` integer
    - `available_balance` object
      - `credits` integer
      - `debits` integer
      - `amount` integer
      - `currency` string
      - `currency_exponent` integer
  - `metadata` object
  - `discarded_at` unknown
  - `created_at` string
  - `updated_at` string

---

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