Create mutation
Book a mutation: a payment, money received or sent, or a general journal entry.
MCP tool e_boekhouden_write → create_mutation
write Confirm
Records one booking. type is 1 to 7: 1 invoice received, 2 invoice sent, 3 invoice payment received, 4 invoice payment sent, 5 money received, 6 money sent, 7 general journal entry. Required: type, date and ledger_id. Rows carry the amount, and for types 3 and 4 the invoice_number they pay. It changes your books and cannot be deleted through the API. By default you confirm each call; you can switch that off for this tool.
Parameters
| Name | Type | Description |
|---|---|---|
| type enum required | enum | 1 to 7, see details. |
| date date required | date | Date of the booking. |
| ledger_id integer required | integer | Ledger ID from list_ledgers. |
| rows array required | array | Rows: amount, description, invoice_number (types 3 and 4), ledger_id (types 1, 2, 5, 6, 7), vat_code, relation_id, cost_center_id. |
| description string | string | Description of the mutation. |
| relation_id integer | integer | Relation of the booking. |
| invoice_number string | string | Invoice number of the mutation. |
| in_ex_vat enum | enum | IN if row amounts include VAT, EX if they exclude it. |
| payment_reference string | string | Payment reference. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "e_boekhouden_write",
"arguments": {
"operation": "create_mutation",
"arguments": {
"type": "3",
"date": "2026-10-12",
"ledger_id": 1155,
"description": "Payout 12 Oct 2026",
"rows": [
{
"invoice_number": "2026-0143",
"amount": 1028.5,
"description": "Payment Studio Noord BV"
}
]
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"mutation_id": 5513,
"type": "3",
"date": "2026-10-12",
"ledger_id": 1155,
"description": "Payout 12 Oct 2026",
"rows": 1,
"amount": 1028.5
},
"isError": false
}