---
title: "Changes to Create a new transaction"
method: POST
path: "/v3/{ledgerName}/transactions"
---

# Changes to Create a new transaction

`POST /v3/{ledgerName}/transactions`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 15 of 119 revisions.

- **2026-11-03** `f5e817eca038`: 1 info
- **2026-10-15** `98fb67e06597`: 2 warning
- **2026-10-09** `0ed18e459f51`: 3 breaking, 4 info
- **2026-10-08** `3da23d327316`: 3 info
- **2026-10-07** `8de1b9405d3e`: 2 info
- **2026-09-30** `465a208afdae`: 1 info
- **2026-09-30** `b747efd5cd77`: 1 info
- **2026-09-29** `6ff73ac9a6bd`: 1 breaking
- **2026-09-11** `4d2bf2f4e2e5`: 1 breaking, 4 warning, 2 info
- **2026-09-04** `57dade10eeb2`: 1 warning
- **2026-09-01** `4d28c76b4328`: 1 info
- **2026-08-28** `fe945da1b75d`: 1 breaking
- **2026-08-28** `ccc19a3ae2df`: 1 breaking
- **2026-08-13** `812efd1474d2`: 3 info
- **2026-07-20** `cf34a2749985`: 1 info

## Changes

- **2026-11-03** `f5e817eca038`: 1 info
  - api operation id `createTransaction` removed and replaced with `v3CreateTransaction`
- **2026-10-15** `98fb67e06597`: 2 warning
  - removed the optional property `data/previousAccountMetadata` from the response with the `201` status
  - removed the optional property `data/warnings` from the response with the `201` status
- **2026-10-09** `0ed18e459f51`: 3 breaking, 4 info
  - response property `data/transaction/postCommitVolumes/additionalProperties/items/input` list-of-types was widened by adding types `integer` to media type `application/json` of response `201`
  - response property `data/transaction/postCommitVolumes/additionalProperties/items/output` list-of-types was widened by adding types `integer` to media type `application/json` of response `201`
  - response property `data/transaction/postings/items/amount` list-of-types was widened by adding types `string` to media type `application/json` of response `201`
  - added the new optional `header` request parameter `Formance-Bigint-As-String`
  - request property `postings/items/amount` list-of-types was widened by adding types `string` to media type `application/json`
  - the `data/transaction/postCommitVolumes/additionalProperties/items/input` response's property pattern `^(0|[1-9][0-9]*)$` was removed for the status `201`
  - the `data/transaction/postCommitVolumes/additionalProperties/items/output` response's property pattern `^(0|[1-9][0-9]*)$` was removed for the status `201`
- **2026-10-08** `3da23d327316`: 3 info
  - added the media type `text/plain` for the response with the status `401`
  - added the media type `text/plain` for the response with the status `403`
  - added the non-success response with the status `429`
- **2026-10-07** `8de1b9405d3e`: 2 info
  - the `data/transaction/postCommitVolumes/additionalProperties/items/input` response's property pattern `^(0|[1-9][0-9]*)$` was added for the status `201`
  - the `data/transaction/postCommitVolumes/additionalProperties/items/output` response's property pattern `^(0|[1-9][0-9]*)$` was added for the status `201`
- **2026-09-30** `465a208afdae`: 1 info
  - added the new optional request property `force`
- **2026-09-30** `b747efd5cd77`: 1 info
  - endpoint added
- **2026-09-29** `6ff73ac9a6bd`: 1 breaking
  - api path removed without deprecation
- **2026-09-11** `4d2bf2f4e2e5`: 1 breaking, 4 warning, 2 info
  - the `data/transaction/metadata/additionalProperties/oneOf[subschema #2]/` response's property format changed from `int64` to no format for status `201`
  - the `accountMetadata/additionalProperties/additionalProperties/oneOf[subschema #2]/` request property's max was set to `18446744073709551616.00`
  - the `metadata/additionalProperties/oneOf[subschema #2]/` request property's max was set to `18446744073709551616.00`
  - the `accountMetadata/additionalProperties/additionalProperties/oneOf[subschema #2]/` request property's min was set to `-9223372036854775808.00`
  - the `metadata/additionalProperties/oneOf[subschema #2]/` request property's min was set to `-9223372036854775808.00`
  - the `accountMetadata/additionalProperties/additionalProperties/oneOf[subschema #2]/` request property format was generalized from `int64` to no format
  - the `metadata/additionalProperties/oneOf[subschema #2]/` request property format was generalized from `int64` to no format
- **2026-09-04** `57dade10eeb2`: 1 warning
  - removed the optional property `data/chapterId` from the response with the `201` status
- **2026-09-01** `4d28c76b4328`: 1 info
  - endpoint added
- **2026-08-28** `fe945da1b75d`: 1 breaking
  - api path removed without deprecation
- **2026-08-28** `ccc19a3ae2df`: 1 breaking
  - the request property `scriptReference/version` became required
- **2026-08-13** `812efd1474d2`: 3 info
  - the response property `data/transaction/metadata` became required for the status `201`
  - the response property `data/transaction/postings` became required for the status `201`
  - the response property `data/transaction/reverted` became required for the status `201`
- **2026-07-20** `cf34a2749985`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/formancehq/apis/ledger-api/docs/v3/:ledgerName/transactions/post.md) - [API](https://skmtc.dev/formancehq/apis/ledger-api.md) - [Page](https://skmtc.dev/formancehq/apis/ledger-api/changes/v3/:ledgerName/transactions/post)