Make + Boekbaar | Help Center
Make (Integromat) is ideaal voor visuele multi-stap scenario's. Er is nog geen officiële Boekbaar-app. Gebruik Custom Webhook + HTTP module.
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
- Voeg een Custom Webhook-module toe als eerste module in je scenario.
- Kopieer de gegenereerde URL.
- Ga naar Boekbaar → Ontwikkelaars → Webhooks → Endpoint aanmaken.
- Plak de Make-URL en selecteer events (bijv. appointment.completed).
- Run Once in Make om de webhook te registreren.
Boekbaar API aanroepen
- Voeg een HTTP-module toe na de webhook-trigger.
- Methode GET of PATCH, URL: https://app.boekbaar.nu/api/v1/...
- Header: Authorization: Bearer [jouw sleutel] (gebruik Make connection of variable).
- Map response-velden naar volgende modules (Sheets, e-mail, etc.).
- OpenAPI: importeer https://app.boekbaar.nu/api/v1/openapi.json in HTTP-module.
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
- Custom Webhook ← Boekbaar appointment.completed
- HTTP GET /appointments/{id}
- HTTP GET /customers/{customerId}
- Google Sheets → Add a row
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
- Webhook ontvangt geen data
- Controleer of het endpoint actief is in Boekbaar en het juiste event is geselecteerd. Stuur developer.test.
- HTTP 403 missing_scope
- Voeg de vereiste scope toe aan je API-sleutel in Boekbaar.
- Make scenario loopt vast
- Controleer error handler en rate limits (120/min).