---
title: "Create a ledger"
method: POST
path: "/v2/{ledger}"
tags: ["ledger.v2"]
---

# Create a ledger

`POST /v2/{ledger}`

## Request body

- V2CreateLedgerRequest
  - `bucket` string — Name of the storage bucket backing the ledger. Ledgers sharing a bucket share a database schema
  - `metadata` V2Metadata — Arbitrary key/value pairs attached to the resource. Metadata is bi-temporal, so a point-in-time query returns the metadata as it stood at that time
  - `features` object — Feature flags to enable on the ledger, keyed by feature name

## Response `204`

OK

## 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/fe945da1b75d/schema)