POST
/
ledgers
curl --request POST \
  --url http://localhost:5001/ledgers \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "Customer Savings Ledger",
    "meta_data": {
      "project_owner": "Acme LLC",
      "description": "For all savings account created & managed by Acme."
    }
  }'

{
  "ledger_id": "ldg_073f7ffe-9dfd-42ce-aa50-d1dca1788adc",
  "name": "Customer Savings Ledger",
  "created_at": "2024-02-20T05:28:03.558281542Z",
  "meta_data": {
    "project_owner": "Acme LLC",
    "description": "For all savings account created & managed by Acme."
  }
}

​
Authorization

Basic authentication header of the form — Basic <encoded-value>, where <encoded-value> is the base64-encoded string of your username:password.

​
Body

​
name
string
required

Name of the ledger. Ensure it is as descriptive as possible for easy reference.

​
meta_data
object

Additional metadata for the request body.

​
Response

​
ledger_id
string
required

Unique id to represent the created ledger.

​
name
string
required

Name of the ledger.

​
created_at
string
required

Indicates the date & time of creation.

​
meta_data
User Object

Additional metadata of the balance.

curl --request POST \
  --url http://localhost:5001/ledgers \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "Customer Savings Ledger",
    "meta_data": {
      "project_owner": "Acme LLC",
      "description": "For all savings account created & managed by Acme."
    }
  }'

{
  "ledger_id": "ldg_073f7ffe-9dfd-42ce-aa50-d1dca1788adc",
  "name": "Customer Savings Ledger",
  "created_at": "2024-02-20T05:28:03.558281542Z",
  "meta_data": {
    "project_owner": "Acme LLC",
    "description": "For all savings account created & managed by Acme."
  }
}

​
Need help?

We are very happy to help you make the most of Blnk, regardless of whether it is your first time or you are switching from another tool.

To ask questions or discuss issues, please contact us or join our Discord community.

Sign up on Blnk Cloud

Connect your Blnk Ledger and explore advanced features (access control & collaboration, anomaly detection, secure storage & file management, etc.) in one intuitive dashboard.

Was this page helpful?

Suggest edits
View ledger details
Next