Create Ledger

POST /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

JSON

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

Response

200

{
    "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"
    }
}