Create vendor

Creates a new vendor (supplier). 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/vendors

Authorization

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

Request Body

name string required Vendor 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 expense 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/vendors

cURL

-cmd">curl --request -method">POST -punct">\
  --url 'https://api.ledgerlou.de/v1/vendors' -punct">\
  --header 'Authorization: Bearer ll_your_key' -punct">\
  --header 'Content-Type: application/json' -punct">\
  --data '{
  "name": "Acme GmbH",
  "vat_id": "DE123456789",
  "iban": "DE89370400440532013000",
  "default_account": "3300"
}'

201 Response

JSON

created vendor.