> For the complete documentation index, see [llms.txt](https://docs.senmo.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.senmo.io/segment-ledger/ledger/create-ledger.md).

# Create Ledger

<mark style="color:green;">`POST`</mark> `/v1/ledgers`

Creates a new ledger.

**Headers**

| Name          | Value              |
| ------------- | ------------------ |
| Content-Type  | `application/json` |
| Authorization | `Bearer API Key`   |

**Body**

| Name          | Type   | Description                      |
| ------------- | ------ | -------------------------------- |
| `name`        | string | Name of the ledger.              |
| `description` | string | Description of the ledger.       |
| `metadata`    | object | Additional application metadata. |

**Example Request**

{% tabs %}
{% tab title="JSON" %}

```json
{
    "name": "Production Ledger",
    "description": "Primary accounting ledger",
    "metadata": {
        "environment": "production",
        "region": "eu-west-1"
    }
}
```

{% endtab %}
{% endtabs %}

**Response**

{% tabs %}
{% tab title="200" %}

```json
{
    "statusCode": 201,
    "statusMessage": "Ledger created successfully",
    "payload": {
        "id": "led_01J9T3M2X5AB7C8D9EFGH12345",
        "name": "Production Ledger",
        "description": "Primary accounting ledger",
        "status": "ACTIVE",
        "created_at": "2026-08-05T14:12:18.462Z"
    }
}
```

{% endtab %}
{% endtabs %}