Booking API-documentatie

Authenticatie

Maak een sleutel aan in Stripbuilder onder Instellingen → Integraties en stuur hem mee als Bearer-token in de Authorization-header. De sleutel wordt één keer getoond, dus bewaar hem veilig. Gebruik hem alleen server-side, nooit in de browser.

Authorization: Bearer sb_live_...

Een boeking aanmaken

Eén verzoek per boeking. Het template-ID en de andere ID's vind je in Stripbuilder onder Instellingen → Integraties.

curl -X POST https://app.stripbuilder.nl/api/v1/bookings \
  -H "Authorization: Bearer sb_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Wedding Jan & Sara",
    "date": "2026-09-12",
    "template_id": "3f2c9a4e-...",
    "location": "Kasteel Bloemendal",
    "external_ref": "CRM-8891",
    "approve": true
  }'

Velden

Veld	Type	Toelichting
`name`Verplicht	string	Naam van de boeking, bijvoorbeeld het event of de klant.
`date`Verplicht	string	Datum van het event als JJJJ-MM-DD.
`template_id`Verplicht	uuid	Het template waarmee je klant begint.
`location`Optioneel	string	Locatie van het event.
`external_ref`Optioneel	string	Je eigen referentie, zoals een boekingsnummer. Een herhaald verzoek met dezelfde referentie geeft de bestaande boeking terug.
`approve`Optioneel	boolean	Met true gaat de boeking direct live en krijg je de klantlink terug. Zonder dit veld landt de boeking in je aanvragen-inbox.
`primary_product_id`Optioneel	uuid	Het geboekte photobooth-pakket.
`upsell_selections`Optioneel	array	Extra's die al geboekt zijn, als lijst met product_id en qty. Elke extra telt één keer.
`questionnaire_template_id`Optioneel	uuid	De vragenlijst die je klant invult. Laat weg voor geen vragenlijst.
`expires_at`Optioneel	ISO 8601	Tot wanneer de klantlink werkt (ISO 8601).

{
  "primary_product_id": "<product-id>",
  "upsell_selections": [{ "product_id": "<product-id>", "qty": 1 }],
  "questionnaire_template_id": "<questionnaire-id>",
  "expires_at": "2026-10-01T00:00:00Z"
}

Antwoord

Je krijgt 201 met de nieuwe boeking. Met approve: true staat de klantlink in client_url. Bestaat er al een boeking met dezelfde external_ref, dan krijg je 200 met die boeking en duplicate: true.

HTTP/1.1 201 Created

{
  "id": "b7d1e0c2-...",
  "status": "pending",
  "external_ref": "CRM-8891",
  "dashboard_url": "https://app.stripbuilder.nl/dashboard/bookings/b7d1e0c2-...",
  "client_url": "https://app.stripbuilder.nl/c/Xk3n9Qe..."
}

Foutcodes

Code	Betekenis
400	Een verplicht veld ontbreekt, de datum is ongeldig of een ID hoort niet bij jouw account.
401	De API-sleutel ontbreekt of is ingetrokken.
403	Je maandlimiet is bereikt. Dit kan alleen bij approve: true; anders blijft de aanvraag in je inbox staan.
429	Te veel verzoeken. Maximaal 60 per minuut.

Stappenplannen

Zapier

1Kies als trigger de nieuwe boeking in je boekingstool.
2Voeg de actie Webhooks by Zapier → Custom Request toe, met methode POST en het endpoint hierboven als URL.
3Zet bij Headers de Authorization-header met Bearer en je sleutel, en Content-Type op application/json.
4Map naam, datum en je template-ID in de body en zet approve op true.
5Gebruik client_url uit het antwoord in je volgende stap, bijvoorbeeld je bevestigingsmail.

Make

1Voeg na je boekingstrigger de module HTTP → Make a request toe.
2Kies methode POST, het endpoint als URL en body type Raw met content type JSON.
3Voeg de Authorization-header toe met Bearer en je sleutel.
4Map de velden in de JSON-body.
5Gebruik client_url uit het antwoord in je mail- of CRM-module.

n8n

1Voeg na je trigger een HTTP Request-node toe.
2Kies methode POST en het endpoint als URL.
3Kies bij authenticatie Header Auth, met Authorization als naam en Bearer plus je sleutel als waarde.
4Zet Send Body aan, kies JSON en map de velden.
5Lees client_url uit in de volgende node.

Eigen website of systeem

1Roep het endpoint aan vanuit je backend zodra een boeking bevestigd is. Nooit vanuit de browser: je sleutel moet geheim blijven.
2Stuur je eigen boekingsnummer mee als external_ref, zodat een herhaald verzoek veilig is.
3Sla client_url op bij de boeking en zet hem in je bevestigingsmail.

Booking API