Create payment run

Creates a new payment run in draft status. Groups selected open AP invoices for SEPA payment. Invoices must have vendors with valid IBANs. Each invoice can only be in one active payment run at a time.

create_payment_run

Authorization

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

Scopes

kreditoren:write

Parameters

bank_account_id string (uuid) required UUID of the bank account to pay from

execution_date string required Requested execution date (YYYY-MM-DD)

invoice_ids array required UUIDs of invoices to include

label string optional Optional label (max 200)

Response

200

Success

MCP create_payment_run

JSON

{
  "tool": "create_payment_run",
  "params": {
    "bank_account_id": "<string>",
    "execution_date": "<string>",
    "invoice_ids": [
      "<string>"
    ],
    "label": "<string>"
  }
}

200 Response

JSON

{
  "id": "<string>",
  "status": "<string>",
  "execution_date": "<string>",
  "total_amount": 1,
  "item_count": 1
}