Moneybird

Getting a token

1. Sign in to Moneybird and open Instellingen → Koppelingen → API-tokens (Settings → Integrations → API tokens).
2. Create a personal access token and put it in MONEYBIRD_API_TOKEN.
3. Set MONEYBIRD_ADMINISTRATION_ID to the numeric administration id. It is in the URL when you are logged in — moneybird.com/123456789/… — and moneybird_list_administrations also returns it.

Every data path carries the administration id. A Moneybird account can hold several administrations (one per company, or a bookkeeper's client list) and each has its own id. This connector is fixed to one; add a second connector for a second administration.

Rate limit: roughly 150 requests per five minutes per token, and Moneybird answers a burst with 429 plus a Retry-After. Pace bulk work rather than retrying immediately.

Filtering is a single comma-separated string, not repeated parameters: filter=period:this_year,state:open. Available keys differ per resource — for sales invoices the useful ones are period, state (all, draft, open, scheduled, pending_payment, late, reminded, paid, uncollectible; combine with a pipe, e.g. state:open|late) and contact_id. A filter you pass replaces the defaults entirely (period:this_year, state:all), so include period when you need anything outside the current year.

Paging is page (1-based) and per_page (max 100). There is no total count in the body; a short page means you have reached the end. Financial mutations are the exception: that endpoint has no paging and returns at most 100 rows, so narrow it with period (e.g. period:20260101..20260131).

Amounts are strings in euros, and total_price_incl_tax is not total_price_excl_tax. Pick the one the question actually means.

Cloud reachability: moneybird.com is public with a valid certificate.