Wat zijn webhooks?
Webhooks zijn HTTP POST-verzoeken die Quoty automatisch verstuurt naar een door jou ingestelde URL wanneer bepaalde events plaatsvinden. Zo koppel je Quoty aan externe systemen.
Beschikbare webhook events
| Event | Wanneer |
|---|---|
| quote_sent | Offerte is verstuurd |
| quote_viewed | Offerte is bekeken |
| quote_accepted | Offerte is geaccepteerd |
| quote_rejected | Offerte is afgewezen |
| deal_stage_changed | Deal is naar andere fase verplaatst |
| deal_created | Nieuwe deal aangemaakt |
| form_submitted | Leadformulier is verstuurd |
| appointment_booked | Afspraak is ingepland |
| contact_created | Nieuw contact aangemaakt |
Webhook configureren
Webhooks zijn op meerdere plekken in te stellen:
- Deal fases - webhook per fase via Deal fases instellingen
- Leadformulieren - webhook per formulier via Formulier webhooks
- Automations - webhook als actie via de automation builder
Payload format
Elke webhook stuurt een JSON payload:
{
"event": "event_type",
"timestamp": "2026-02-20T10:30:00Z",
"data": {
// Event-specifieke data
}
}
De data inhoud verschilt per event type en bevat alle relevante informatie.
Testen
Met webhook.site
- Ga naar webhook.site
- Kopieer de unieke URL
- Plak deze als webhook URL in Quoty
- Trigger het event (bijv. verstuur een offerte)
- Controleer de ontvangen payload op webhook.site
Met cURL
Test je eigen endpoint met een voorbeeld payload:
curl -X POST https://jouw-endpoint.nl/webhook \
-H "Content-Type: application/json" \
-d '{"event":"quote_accepted","timestamp":"2026-02-20T10:30:00Z","data":{"quote_id":"123"}}'
Beveiligings tips
- Gebruik HTTPS endpoints
- Valideer de payload in je ontvangend systeem
- Reageer met een 200 status code om ontvangst te bevestigen
Gerelateerde artikelen
- Deal webhooks - webhooks per deal fase
- Formulier webhooks - webhooks voor formulieren
- Acties - webhook als automation actie