API

API-referentie

Alles wat je in de UI kunt, kun je ook via de API. Een voorspelbare REST API, realtime webhooks en officiële SDK’s om The Agency CRM aan je eigen stack te koppelen.

Laatst bijgewerkt: 16 juli 2026

Basis

De API is een REST API met JSON-payloads en heldere foutcodes. Elke request wordt geauthenticeerd met een API-key of een OAuth2-token. Alle write-operaties ondersteunen idempotency-keys, zodat je veilig opnieuw kunt proberen zonder dubbele records.

Authenticatie

Geef je API-key mee in de Authorization-header. Maak keys aan in het dashboard onder Instellingen → API. Keys zijn scoped en op elk moment intrekbaar.

curl https://api.theagencycrm.nl/v1/deals \
  -H "Authorization: Bearer YOUR_API_KEY"

Belangrijkste resources

GET /v1/leads — Haal leads op, met cursor-gebaseerde paginering.
POST /v1/deals — Maak een deal aan en plaats hem in een pipeline-fase.
POST /v1/invoices — Maak een factuur aan en verstuur hem met een betaallink.
GET /v1/clients — Doorzoek en beheer je klanten en contactpersonen.

Webhooks

Ontvang events zodra ze gebeuren — nieuwe deal, gewonnen deal, betaalde factuur — met automatische retries en handtekening-verificatie. Configureer endpoints in het dashboard en verifieer elke payload met de meegestuurde handtekening.

MCP

Naast de REST API biedt The Agency CRM een MCP-server (Model Context Protocol). Daarmee koppel je AI-assistenten rechtstreeks aan je CRM en roep je dezelfde acties aan die de ingebouwde assistent gebruikt.

Test al je integraties eerst tegen de gratis sandbox met echte datastructuren, zodat je productie-omgeving onaangeroerd blijft.

Volledige referentie

De complete endpoint-documentatie met request- en response-voorbeelden, SDK’s en de OpenAPI-spec vind je op de developers-pagina.

Bekijk de developers-portal