---
title: "[DEPRECATED] Create Ledger Account Payout"
method: POST
path: "/ledger_account_payouts"
---

# \[DEPRECATED\] Create Ledger Account Payout

`POST /ledger_account_payouts`

## Request

- Base URL: `https://app.moderntreasury.com/api`
- URL: `https://app.moderntreasury.com/api/ledger_account_payouts`
- Auth: HTTP basic

## Request body

- object
  - `description` string
  - `status` string: It is set to `pending` by default. To post a ledger account payout at creation, use `posted`.
  - `payout_ledger_account_id` string, required: The ledger account whose ledger entries are queried against, and its balance is reduced as a result.
  - `funding_ledger_account_id` string, required: The ledger account that sends to or receives funds from the payout ledger account.
  - `effective_at_upper_bound` string, date: The maximum effective_at timestamp of the ledger entries to be included in the ledger account payout. The default value is the created_at timestamp of the ledger account payout.
  - `allow_either_direction` boolean: If true, the payout amount and payout_entry_direction will bring the payout ledger account’s balance closer to zero, even if the balance is negative.
  - `metadata` string, json: Metadata to be added to the ledger account payout. Must be a JSON object.
  - `skip_payout_ledger_transaction` boolean: It is set to `false` by default. It should be set to `true` when migrating existing payouts.

## Response `201`

201

- object
  - `id` string
  - `object` string
  - `live_mode` boolean
  - `description` string
  - `payout_ledger_account_id` string
  - `funding_ledger_account_id` string
  - `effective_at_upper_bound` string
  - `status` string
  - `amount` unknown
  - `currency` string
  - `ledger_transaction_id` unknown
  - `metadata` object
    - `foo` string
  - `created_at` string
  - `updated_at` string

## Other responses

- `422`: 422

## Changes

- **2026-11-03** `e31c6638c72e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/modern-treasury/apis/modern-treasury-api/changes/ledger_account_payouts/post.md)

---

[API](https://skmtc.dev/modern-treasury/apis/modern-treasury-api.md) - [All operations](https://skmtc.dev/modern-treasury/apis/modern-treasury-api/llms.txt) - [OpenAPI document](https://skmtc.dev/modern-treasury/apis/modern-treasury-api/revisions/e31c6638c72e?raw)