Create customer

Creates a new customer. The optional default account must exist in the chart of accounts. Duplicate VAT IDs are rejected.

create_customer

Authorization

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

Scopes

debitoren:write

Parameters

name string required Customer name (max 255)

vat_id string optional VAT ID (max 20)

tax_id string optional Tax number (max 20)

iban string optional IBAN (max 34)

bic string optional BIC (max 11)

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

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

notes string optional Free-text notes (max 2000)

Response

200

Success

MCP create_customer

JSON

{
  "tool": "create_customer",
  "params": {
    "name": "<string>",
    "vat_id": "<string>",
    "iban": "<string>",
    "default_account": "<string>"
  }
}

200 Response

JSON

{
  "id": "<string>",
  "name": "<string>",
  "vat_id": "<string>",
  "iban": "<string>",
  "default_account": "<string>",
  "is_active": true
}