Create mutation
Book a mutation: a payment, money received or sent, or a general journal entry.
POST https://cotlet.dev/api/v1/e-boekhouden/ledgers/{ledger_id}/mutations
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. |
Request
curl -X POST https://cotlet.dev/api/v1/e-boekhouden/ledgers/1155/mutations \
-H "Authorization: Bearer $COTLET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"type":"3","date":"2026-10-12","description":"Payout 12 Oct 2026","rows":[{"invoice_number":"2026-0143","amount":1028.5,"description":"Payment Studio Noord BV"}]}'result = client.call("e-boekhouden", "create_mutation", {"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"}]})const result = await cotlet.call('e-boekhouden', 'create_mutation', {"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"}]});cotlet call e-boekhouden create_mutation --data '{"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
{
"mutation_id": 5513,
"type": "3",
"date": "2026-10-12",
"ledger_id": 1155,
"description": "Payout 12 Oct 2026",
"rows": 1,
"amount": 1028.5
}