Zapier + Boekbaar | Help Center
Zapier verbindt Boekbaar met duizenden apps via Webhooks by Zapier. Er is nog geen officiële Boekbaar-app.
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
- Maak een Zap met trigger: Webhooks by Zapier → Catch Hook.
- Kopieer de Custom Webhook URL.
- Boekbaar → Webhooks → nieuw endpoint met die URL.
- Selecteer events en sla op.
- Test de Zap met developer.test in Boekbaar.
Boekbaar API aanroepen
- Voeg actie toe: Webhooks by Zapier → GET of POST.
- URL: https://app.boekbaar.nu/api/v1/customers (of ander endpoint).
- Header Authorization: Bearer + API-sleutel.
- Map velden naar volgende Zap-stappen.
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
- Catch Hook ← customer.created
- Webhooks GET /customers/{id}
- HubSpot → Create Contact
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
- Zap is uitgeschakeld
- Zapier schakelt Zaps uit na herhaalde errors, controleer Task History.
- 401 invalid_api_key
- Controleer Bearer-token in Webhooks-stap.