n8n + Boekbaar | Help Center
n8n biedt self-hosted workflows met Webhook + HTTP Request nodes. Gebruik Webhook + HTTP Request nodes, geen officiële Boekbaar-node.
Vereisten
- Actieve Developer/API add-on in Boekbaar.
- Voor webhooks: Webhooks add-on actief.
- API-sleutel met de juiste scopes voor je workflow.
- Account bij het gekozen automation-platform.
Webhook aanmaken
- Nieuwe workflow → Webhook-node (POST).
- Kopieer Production URL.
- Boekbaar webhooks → endpoint met die URL.
- Activeer workflow en test met developer.test.
Boekbaar API aanroepen
- HTTP Request-node na webhook.
- Authentication: Header Auth met Bearer token (credential).
- Base URL: https://app.boekbaar.nu/api/v1
- Optioneel: OpenAPI import in HTTP Request (experimenteel).
Authenticatie
- Boekbaar API: Authorization: Bearer bk_live_xxxxx
- Sla de sleutel op in het secret/credential-systeem van je platform.
- Gebruik nooit query parameters voor API-sleutels.
- Roteer sleutels via Dashboard → Ontwikkelaars → API-sleutels.
Voorbeeldworkflow
- Webhook POST
- HTTP Request GET /appointments/{{ $json.data.id }}
- HTTP Request naar Moneybird API (eigen credentials)
Beveiliging
- Plak API-sleutels nooit in publieke templates of gedeelde scenario's.
- Verifieer X-Boekbaar-Signature op webhook-endpoints waar mogelijk.
- Gebruik least-privilege scopes per workflow.
- Test eerst met developer.test webhook-event.
Probleemoplossing
- Signature verification faalt
- Gebruik Function-node met HMAC SHA-256 en X-Boekbaar-Signature header.
- Workflow niet actief
- Zet workflow op Active en gebruik Production URL, niet Test URL.