Eingehende Webhooks sind eine einfache Möglichkeit, Leads aus externen Quellen in Leadnodes zu erstellen. Sie verwenden normale HTTP-Anfragen mit einem JSON-Payload, der die Lead-Daten und ein paar andere optionale Details enthält, die später beschrieben werden.
Endpoint URL
https://app.leadnodes.com/hooks/heyflow/{#USER-API-KEY#}/{#LEAD-Type-ID#}
Wichtig:
Die Parameter {#USER-API-KEY#} und {#LEAD-Type-ID#} müssen ersetzt werden.
Webhook Structure
lead_type_id (INT, Pflicht)
Leadnodes Lead Typ ID.
gender (STRING, optional)
Geschlecht (m = männlich, f = weiblich).
first_name (STRING, optional)
Vorname des Leads.
last_name (STRING, optional)
Nachname des Leads.
fullname (STRING, optional)
Kombination aus Vor- und Nachname, getrennt durch Leerzeichen.
birth_date (DATE, optional)
Geburtsdatum des Leads.
street_no (STRING, optional)
Straße und Hausnummer des Leads.
zip_code (STRING, optional)
Postleitzahl des Leads.
phone (STRING, optional)
Telefonnummer des Leads.
email (STRING, optional)
E-Mail-Adresse des Leads.
custom_data (ARRAY, optional)
Benutzerdefinierte Felder.
ip (STRING, optional)
IP-Adresse.
uuid_required (BOOL, optional)
Gibt an, ob eine UUID erforderlich ist.
uuid (STRING, optional): Universell eindeutiger Bezeichner (UUID).
campaignid (STRING, optional)
Kampagnen-ID für Gruppierungen.
creative (STRING, optional)
Werbemittel (z.B. Banner, Link).
device (STRING, optional)
Gerät: m = Mobil, t = Tablet, d = Desktop.
keyword (STRING, optional)
Schlüsselwort.
matchtype (STRING, optional)
Übereinstimmungstyp: e = exact, b = broad, p = phrase.
placement (STRING, optional)
Werbeplatzierung (Website, App, Newsletter).
newsletter_optin (BOOL, optional)
Newsletter-Zustimmung.
affili_id (INT, optional)
Benutzer-ID des Affiliate-Nutzers.
JSON Payload Example (one dimensional json-object)
{
"lead_type_id": "1",
"gender": "m",
"first_name": "John",
"last_name": "Dow",
"birth_date": "1982-10-02",
"street_no": "Nieder-Kinziger-Str. 27b",
"zip_code": "64732",
"city": "Frankfurt",
"phone": "+49465465466",
"email": "[email protected]",
"ip": "192.186.105.13",
"uuid": "ID1234678XYZ",
"campaignid": "12345",
"creative": "ad name",
"device": "m",
"keyword": "keyword",
"matchtype": "e",
"placement": "google.com",
"newsletter_optin": "0",
// custom data examples
"custom_data_field1": "Value A",
"custom_data_field2": "Value B",
"custom_data_field3": "Value B"
}
Wichtig!
Die Parameter „custom_data_field1, custom_data_field2, custom_data_field3“ sind Beispiele für die tatsächlichen benutzerdefinierten Parameter, die im Lead-Typ definiert wurden.
Wichtig!
Achten Sie lediglich darauf, dass die Parameter in Heyflow mit denen deiner jeweiligen Leadsparte übereinstimmen.
