Add an account

Adds a new custom account to the chart of accounts. System accounts cannot be duplicated.

POST /v1/accounts

Authorization

Authorization string header required API key in the format ll_.... Pass as a Bearer token.

Request Body

number string required Account number (numeric, max 8 digits)

name string required Account label (max 255)

type string required "asset", "liability", "equity", "revenue" or "expense"

category string optional Category (max 100)

report_group string optional Report grouping key for BWA/Bilanz/GuV classification (max 40). Canonical values: revenue, material_expense, personnel_expense, depreciation, other_opex, cash, receivables, liabilities, etc.

Responses

201

Success

400

INVALID_INPUT Required fields are missing or values do not match the expected format.

409

DUPLICATE_ACCOUNT

POST /v1/accounts

cURL

-cmd">curl --request -method">POST -punct">\
  --url 'https://api.ledgerlou.de/v1/accounts' -punct">\
  --header 'Authorization: Bearer ll_your_key' -punct">\
  --header 'Content-Type: application/json' -punct">\
  --data '{
  "number": "6817",
  "name": "Cloud-Infrastruktur",
  "type": "expense",
  "category": "IT-Kosten",
  "report_group": "other_opex"
}'

201 Response

JSON

{
  "number": "<string>",
  "name": "<string>",
  "type": "<string>",
  "category": "<string>",
  "report_group": "<string>",
  "is_system": true
}