---
title: "Create a new transaction to a ledger"
method: POST
path: "/{ledger}/transactions"
tags: ["ledger.v1"]
---

# Create a new transaction to a ledger

`POST /{ledger}/transactions`

## Path parameters

- `ledger` string, required

## Query parameters

- `preview` boolean

## Request body

- PostTransaction
  - `timestamp` string, date-time
  - `postings` Posting[]
    - `amount` integer, required
    - `asset` string, required
    - `destination` string, required
    - `source` string, required
  - `script` object
    - `plain` string, required
    - `vars` object
  - `reference` string
  - `metadata` Metadata, nullable

## Response `200`

OK

- TransactionsResponse
  - `data` Transaction[], required
    - `timestamp` string, date-time, required
    - `postings` Posting[], required
      - `amount` integer, required
      - `asset` string, required
      - `destination` string, required
      - `source` string, required
    - `reference` string
    - `metadata` Metadata, nullable
    - `txid` integer, required
    - `preCommitVolumes` AggregatedVolumes
    - `postCommitVolumes` AggregatedVolumes

## Other responses

- `default` — Error

---

[API](https://skmtc.dev/formancehq/apis/ledger-api.md) · [All operations](https://skmtc.dev/formancehq/apis/ledger-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/formancehq/ledger-api/revisions/7ee573f0087f/schema)