Create customer

Creates a new customer. An optional default account must exist in the chart of accounts. Duplicates are detected by name (case-insensitive), tax number and VAT ID.

POST /v1/customers

Authorization

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

Request Body

name string required Customer name (max 255)

tax_id string optional Tax number (max 20)

vat_id string optional VAT ID (max 20)

iban string optional IBAN (max 34)

bic string optional BIC (max 11)

address object optional Address with street, city, zip, country

default_account string optional Default revenue account (must exist in the chart of accounts)

notes string optional Free-text notes (max 2000)

Responses

201

Success

400

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

400

ACCOUNT_NOT_FOUND The specified expense or revenue account does not exist in the chart of accounts.

409

DUPLICATE_NAME

409

DUPLICATE_TAX_ID

409

DUPLICATE_VAT_ID

POST /v1/customers

cURL

-cmd">curl --request -method">POST -punct">\
  --url 'https://api.ledgerlou.de/v1/customers' -punct">\
  --header 'Authorization: Bearer ll_your_key' -punct">\
  --header 'Content-Type: application/json' -punct">\
  --data '{
  "name": "Musterkunde AG",
  "vat_id": "DE987654321",
  "iban": "DE27100777770209299700",
  "default_account": "8400"
}'

201 Response

JSON

created customer.