Webhook: payload en velden
Naslag voor webbouwers. Hoe het JSON-bericht van de meetpiloot-webhook eruitziet, welke events er zijn en welke velden je kunt verwachten.
Op deze pagina3
Elk bericht is een POST met een JSON-body. De headers X-Meetpiloot-Signature en X-Meetpiloot-Timestamp gebruik je om het bericht te controleren. De header X-Meetpiloot-Delivery is de vaste ID van de bezorging, waarmee je een herhaald bericht herkent (zie bezorging).
Events
| Event | Wanneer |
|---|---|
lead.created | Er is een nieuwe lead binnengekomen. |
lead.status_changed | De status van een lead is gewijzigd, bijvoorbeeld van offerte verstuurd naar gewonnen. Bevat ook previous_status. |
lead.test | Een testbericht vanuit je dashboard. Maak hier geen record van aan in je CRM. |
Voorbeeld
{
"event": "lead.created",
"sent_at": "2026-09-22T10:00:00.000Z",
"company_id": "0c9f...",
"lead": {
"id": "8f2a...",
"reference_number": "MP-1042",
"created_at": "2026-09-22T09:59:00.000Z",
"status": "new",
"lead_source": "configurator",
"product_type": "veranda",
"customer_name": "Jan de Vries",
"customer_email": "[email protected]",
"customer_phone": "+31612345678",
"customer_address": "Dorpsstraat 1",
"customer_country": "NL",
"quoted_price": 7450.5,
"currency": "EUR",
"width_m": 4,
"depth_m": 3,
"calculated_area_sqm": 12
},
"attribution": {
"utm_source": "google",
"utm_medium": "cpc",
"utm_campaign": "veranda-najaar",
"utm_term": "veranda op maat",
"utm_content": "advertentie-a",
"gclid": "Cj0KCQ...",
"landing_page_url": "https://jouwsite.nl/offerte?utm_source=google",
"referrer": "https://www.google.com/"
}
}Herkomstvelden
De sleutels in attribution staan plat naast elkaar, zodat je ze in Zapier of Make één op één kunt koppelen. Mogelijke sleutels:
| Groep | Sleutels |
|---|---|
| Klik-ID's | gclid, gbraid, wbraid, msclkid, fbclid, ttclid |
| Campagne | utm_source, utm_medium, utm_campaign, utm_term, utm_content |
| Context | landing_page_url, referrer |
Een veld dat niet gemeten is, ontbreekt. Het wordt nooit als lege tekst verstuurd. De velden in lead zijn altijd aanwezig en kunnen null zijn.
Lees ook
Kom je er niet uit?
Mail ons of open een ticket vanuit je dashboard. Antwoord binnen 1 tot 2 werkdagen.