Kurzantwort
Der Webhook-Export sendet bei jeder Lead-Zuweisung (oder optional bei der Lead-Erstellung) automatisch ein JSON-Objekt an die von Ihnen hinterlegte URL. Das Objekt enthält die Stammdaten des Leads, alle benutzerdefinierten Felder, Informationen zum Kauf sowie alle Anhänge.
Detaillierte Anleitung
Mit der Webhook-Integration können Sie Lead-Daten in Echtzeit an Ihr eigenes System oder ein Drittsystem übertragen. Sobald ein Lead zugewiesen (oder erstellt) wird, wird Ihre Webhook-URL automatisch aufgerufen.
So richten Sie einen Webhook ein
Navigieren Sie zu Einstellungen > Integrationen > Webhooks.
Klicken Sie auf Webhook hinzufügen.
Tragen Sie die Ziel-URL ein, an die die Daten gesendet werden sollen.
Wählen Sie den Lead-Typ aus (oder „Alle Lead-Typen“).
Wählen Sie den Auslöser: Nach Lead-Zuweisung oder Nach Lead-Erstellung.
Aktivieren Sie die Integration und speichern Sie.
Aufbau der Payload
Die Daten werden als JSON per POST-Anfrage übertragen. Ein Beispiel:
{
"id": 12345,
"lead_type_id": 7,
"gender": "male",
"first_name": "John",
"last_name": "Doe",
"company": null,
"street_no": "Hauptstraße 12a",
"zip_code": "10115",
"city": "Berlin",
"country_code": "DE",
"phone": "+49 170 1234567",
"email": "[email protected]",
"birth_date": "1985-04-12",
"roof_size": "85",
"energy_consumption": "4200",
"has_battery": "yes",
"lead_type_short_code": "PV",
"buyer_id": 42,
"buyer_price": "149.00",
"assignment_date": "2026-06-15T10:32:00.000000Z",
"attachments": [
{
"id": 988,
"field_name": "roof_photo",
"filename": "roof.jpg",
"mime_type": "image/jpeg",
"file_size": 284910,
"download_url": "https://...signed...",
"expires_at": "2026-06-15T10:37:00+00:00"
}
]
}Enthaltene Felder
Stammdaten: id, lead_type_id, gender, first_name, last_name, company, street_no, zip_code, city, country_code, phone, email, birth_date
Benutzerdefinierte Felder: alle Felder Ihres Lead-Typs werden auf oberster Ebene mit eingefügt (z. B. roof_size, energy_consumption).
Kauf- und Zuweisungsdaten: lead_type_short_code, buyer_id, buyer_price (Standard „0.00“), assignment_date
Anhänge: Liste mit id, field_name, filename, mime_type, file_size sowie je nach Methode einer Download-URL.
Weitere häufig gestellte Fragen
Wann wird der Webhook ausgelöst?
Standardmäßig nach jeder Lead-Zuweisung. Alternativ können Sie „Nach Lead-Erstellung“ wählen. Pro Webhook können Sie zusätzlich auf einen bestimmten Lead-Typ einschränken.
Welche benutzerdefinierten Felder werden gesendet?
Es werden automatisch alle benutzerdefinierten Felder des jeweiligen Lead-Typs auf oberster Ebene der Payload übertragen. Eine manuelle Zuordnung einzelner Felder ist nicht erforderlich.
Kann ich nur öffentliche Daten senden?
Ja. Aktivieren Sie für den jeweiligen Webhook die Option „Nur öffentliche Daten“. Dann werden ausschließlich die als öffentlich markierten benutzerdefinierten Felder übertragen.
Wie werden Anhänge übertragen?
Anhänge werden im Feld attachments übergeben. Je nach Einstellung erhalten Sie eine zeitlich begrenzte Download-URL (Standard), den Datei-Inhalt als Base64 oder einen tokenbasierten Download-Link. Download-Links haben ein Ablaufdatum (Feld expires_at).
Kann ich die Feldnamen anpassen?
Ja. Aktivieren Sie den Daten-Mapper in der Webhook-Konfiguration. Damit können Sie die Standard-Feldnamen auf Ihre eigenen Zielfelder umbenennen oder umstrukturieren.
Wie kann ich prüfen, ob die Anfrage echt ist?
Jede Anfrage enthält einen Signature-Header (HMAC-SHA256). Damit kann Ihr System die Echtheit der Anfrage überprüfen. Den dafür nötigen geheimen Schlüssel erhalten Sie auf Anfrage von unserem Support-Team.