Webhook: Payload und Felder
Nachschlagewerk für Webentwickler. Wie die JSON-Nachricht des meetpiloot-Webhooks aussieht, welche Events es gibt und welche Felder du erwarten kannst.
Auf dieser Seite3
Jede Nachricht ist ein POST mit einem JSON-Body. Mit den Headern X-Meetpiloot-Signature und X-Meetpiloot-Timestamp prüfst du die Nachricht. Der Header X-Meetpiloot-Delivery ist die feste ID der Zustellung, mit der du eine wiederholte Nachricht erkennst (siehe Zustellung).
Events
| Event | Wann |
|---|---|
lead.created | Ein neuer Lead ist eingegangen. |
lead.status_changed | Der Status eines Leads hat sich geändert, zum Beispiel von Angebot versendet zu Gewonnen. Enthält auch previous_status. |
lead.test | Eine Testnachricht aus deinem Dashboard. Leg dafür keinen Datensatz in deinem CRM an. |
Beispiel
{
"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 Becker",
"customer_email": "[email protected]",
"customer_phone": "+4915112345678",
"customer_address": "Dorfstraße 1",
"customer_country": "DE",
"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": "terrassendach-herbst",
"utm_term": "terrassenüberdachung nach maß",
"utm_content": "anzeige-a",
"gclid": "Cj0KCQ...",
"landing_page_url": "https://deinewebsite.de/angebot?utm_source=google",
"referrer": "https://www.google.com/"
}
}Herkunftsfelder
Die Schlüssel in attribution stehen flach nebeneinander, damit du sie in Zapier oder Make eins zu eins zuordnen kannst. Mögliche Schlüssel:
| Gruppe | Schlüssel |
|---|---|
| Klick-IDs | gclid, gbraid, wbraid, msclkid, fbclid, ttclid |
| Kampagne | utm_source, utm_medium, utm_campaign, utm_term, utm_content |
| Kontext | landing_page_url, referrer |
Ein Feld, das nicht gemessen wurde, fehlt. Es wird nie als leerer Text gesendet. Die Felder in lead sind immer vorhanden und können null sein.
Auch interessant
Kommst du nicht weiter?
Schreib uns oder öffne ein Ticket in deinem Dashboard. Antwort innerhalb von 1 bis 2 Werktagen.