Naar de hoofdinhoud

Zelf een koppeling maken

Lees hoe je zelf een koppeling kunt maken met de Moneybird API.

Is er nog geen koppeling beschikbaar? Dan kun je er zelf een bouwen. Hiervoor is technische kennis van programmeren nodig. De API is toegankelijk voor elke Moneybird-gebruiker en Moneybird brengt geen extra kosten in rekening. De documentatie van de Moneybird API vind je hier terug.

In onze API Integration guide vind je een aantal van onze meest voorkomende use cases. Per use case vind je een duidelijk stappenplan dat uitlegt hoe je de API stap voor stap kunt integreren. Dit omvat onder andere het instellen van authenticatiegegevens, de vereisten vooraf en het versturen van de request.

Daarnaast geven we per stap praktische voorbeelden in curl, zodat je meteen ziet hoe een request eruitziet.

Jouw koppeling op onze website

Wil je dat we de koppeling ook op onze site aanbieden voor andere gebruikers? Dan moet de koppeling aan een aantal eisen voldoen. Privacy is voor ons erg belangrijk, en we verwachten dat ook van de gekoppelde partij:

  • De koppeling mag geen inloggegevens van Moneybird-accounts opvragen.

  • Gebruik een OAuth-koppeling die alleen toegang vraagt tot de benodigde onderdelen.

Naast privacy zijn ook de volgende punten verplicht:

  • De koppeling heeft minstens 25 actieve administraties en is al minstens 2 maanden actief.

  • De koppeling maakt gebruik van de Refresh token en haalt niet continu nieuwe access tokens op.

  • De koppeling respecteert de rate limit van 150 requests per 5 minuten.

  • De koppeling maakt gebruik van webhooks en pollt niet continu.

  • De koppeling voert correcte acties uit in Moneybird. Als er boekingen worden aangemaakt, moeten deze boekhoudkundig kloppen. Dit testen wij voordat we je koppeling vermelden.

  • Je biedt ondersteuning aan gebruikers bij vragen of problemen met jouw koppeling.

Wil je een koppeling op onze site toevoegen of heb je vragen over het maken van een nieuwe API koppeling, dan kun je contact opnemen met onze support. Als je een koppeling op onze site wilt vermelden, ontvangen we graag de volgende gegevens:

  1. Een screenshot van het API token via Gebruikersaccount > Ontwikkelaars.

    informatie bij Gebruikersaccount > Ontwikkelaars
  2. Een testaccount voor jouw applicatie, zodat we de koppeling kunnen testen.

  3. Een link naar de documentatie die ook beschikbaar is voor de daadwerkelijke gebruikers van de koppeling.

  4. Informatie over tot welke scopes de koppeling toegang vraagt en een korte toelichting waarom.

Moneybird behoudt altijd het recht te beslissen de koppeling niet op de website toe te voegen.

Moneybird CLI

Moneybird heeft een open-source command-line interface (CLI) beschikbaar via github.com/moneybird/moneybird-cli. De CLI leest de Moneybird OpenAPI-specificatie en ondersteunt daarmee automatisch alle endpoints uit de API, inclusief nieuwe endpoints zodra die beschikbaar komen.

De CLI is handig als je:

  • Snel API-calls wilt doen zonder zelf een request op te bouwen.

  • Een AI-agent toegang wilt geven tot je administratie via de terminal in plaats van via MCP.

  • Uitvoer wilt filteren of doorgeven aan een volgend programma.

Je kunt de output beperken tot specifieke velden, zodat een AI-agent alleen de informatie krijgt die relevant is. Dat is zuiniger met tokens en beter voor de privacy.

De CLI werkt met een API token uit je Moneybird-instellingen. Gebruik een read-only token als de koppeling of agent alleen gegevens hoeft op te halen.

Het ophalen van parameter-ID's via de URL

De parameter-ID (bijvoorbeeld van een workflow, offerte of contact) is zichtbaar in de URL zodra je het betreffende onderdeel opent in het systeem.

Was dit een antwoord op uw vraag?