HubSpot verbinden
Verbinde dein HubSpot-Konto in wenigen Minuten – ohne API-Keys, ohne von Hand verdrahtete Webhooks. Einmal autorisieren, dann CRM-Events wie neue Kontakte, neue Deals und Deal-Stage-Änderungen direkt auf deine Conversions abbilden.
Wenn du HubSpot verbindest, werden CRM-Events – neue Kontakte, neue Deals, Lifecycle- und Deal-Stage-Änderungen – zu LeadJourney-Conversions, automatisch der Kampagne, Ad Set und Anzeige zugeordnet, die sie verdient haben. Du autorisierst HubSpot einmal (keine Keys zum Kopieren, keine Webhook-URLs zum Einfügen) und mappst danach jedes HubSpot-Event auf einen deiner Conversion-Typen. Gemappte Events laufen durch dieselbe Postback-Pipeline wie deine Offline-Conversions und übernehmen so automatisch jeden Ad-Postback, den du bereits eingerichtet hast.
Bevor du startest
Halte das bereit, damit die Verbindung von Anfang bis Ende funktioniert:
- Einen aktiven LeadJourney-Workspace und ein HubSpot-Konto, in das du dich einloggen kannst.
- Tracking ist live – Klicks müssen zuerst erfasst werden, damit CRM-Datensätze einer Kampagne zugeordnet werden können. Siehe Tracking-Script installieren.
- Eine Möglichkeit, die Click-ID auf deinen HubSpot-Datensätzen zu erfassen – typisch ein verstecktes Formularfeld, das LeadJourneys Click-ID auf dem Kontakt speichert (siehe Callout unten).
- Mindestens einen Conversion-Typ zum Mappen (z. B.
WonClient). Richte diese zuerst im Events Manager ein.
Wo du es findest
Öffne Settings → Apps oder gehe zu app.leadjourney.io/settings?slug=apps. Klick auf die HubSpot-Karte, um die Integration zu öffnen. Solange du nicht verbunden bist, siehst du eine „Connect your HubSpot account“-Karte; nach dem Verbinden zeigt derselbe Screen dein Konto, das Portal und deine Trigger.
Schritt für Schritt
LeadJourney aus HubSpot autorisieren
Klick auf der Connect your HubSpot account-Karte auf Connect with HubSpot. Du wirst zu HubSpot weitergeleitet, um dich einzuloggen und den Zugriff von LeadJourney zu bestätigen und auszuwählen, welches HubSpot-Konto verbunden wird.
Die Freigabe gibt Lesezugriff auf deine Kontakte und Deals, plus die Berechtigung, CRM-Objekt-Events zu abonnieren (damit LeadJourney Erstellungen und Property-Änderungen aufnehmen kann) – keine Keys zum Kopieren, keine Webhook-URLs zum Einfügen. Nach der Bestätigung schickt HubSpot dich zurück und du siehst eine „HubSpot connected“-Bestätigung.
Verbindungsdetails prüfen
Sobald du verbunden bist, zeigt der Header alles auf einen Blick: ein Live-Pill (oder Needs reconnect, falls etwas bricht), dein verbundenes Konto und die Portal-ID, wie viele Trigger aktiv sind und das Datum, seit dem du verbunden bist. Ein Disconnect-Button sitzt im selben Header für später.
Einen Trigger hinzufügen
Klick im Triggers-Panel – „Each trigger maps a HubSpot event to one of your conversions.“ – auf Add trigger. Im Dialog New HubSpot trigger:
- App – HubSpot (bereits ausgewählt).
- Object type – wähle Contact oder Deal.
- Event type – wähle Created (ein neuer Datensatz) oder Property changed.
- Property (nur bei Property changed) – wähle, welche Property überwacht wird, z. B. Lifecycle stage, Lead status oder Deal stage.
- Target value (optional) – leer lassen, um bei jeder Änderung zu feuern, oder auf einen Wert festlegen. Bei Deal stage wird daraus ein Dropdown deiner Pipeline-Stufen (mit Any stage change als Standard).
- LeadJourney Event – wähle den Conversion-Typ, den dieses HubSpot-Event aufzeichnen soll,
z. B.
WonClient. (Keine Optionen? Lege zuerst einen unter Settings → Events an.)
Klick auf Continue.
Deal-Stufen kommen aus deinen Pipelines
Wenn du die Deal stage-Property überwachst, lädt LeadJourney deine HubSpot-Pipelines und listet jede Stufe als Pipeline · Stufe, sodass du eine Conversion genau dann feuern kannst, wenn ein Deal z. B. Sales Pipeline · Closed won erreicht.
Daten empfangen und das Mapping bestätigen
Der Dialog öffnet einen Flow mit drei Tabs:
- Receive Data – klick auf Check for Data, um aktuelle Datensätze für das gewählte Objekt und Event zu laden. Erscheint nichts, erstelle oder ändere einen Datensatz in HubSpot und prüfe erneut, dann wähle einen Datensatz zum Mappen aus.
- Configure Mapping – ordne den HubSpot-Datensatz den LeadJourney-Spalten zu – Email,
Full name, First name, Last name, Phone, Zip, click_id, Revenue
und Cash collected – per Add custom field für alles Weitere. Bei Deal-Triggern
kannst du auch Werte vom zugehörigen Kontakt (
contact.…) ziehen. Das Mappen vonclick_idist empfohlen, aber optional (siehe Callout unten). - Filtering (optional) – füge Bedingungen hinzu, damit der Trigger nur bei passenden Datensätzen feuert.
Klick auf Activate, um abzuschließen.
Wie HubSpot-Datensätze mit der richtigen Kampagne verknüpft werden
HubSpot erfasst LeadJourneys Click-ID nicht von allein – du speicherst sie auf dem Datensatz
und mappst sie hier. Üblich ist ein verstecktes Feld in deinem HubSpot-Formular, das die
click_id des Besuchers enthält (LeadJourneys Tracking-Script füllt es) und in eine
Kontakt-Property geschrieben wird. Zeige im Tab Configure Mapping click_id auf diese
Property, und jeder Kontakt oder Deal kommt bereits mit dem Klick – und damit der Kampagne,
Ad Set und Anzeige – verknüpft an, der ihn verdient hat. Keine Click-ID? LeadJourney matcht
als Fallback über email oder phone.
Deine Trigger verwalten
Jeder Trigger erscheint als Zeile – z. B. Deal · dealstage → Conversion-Typ – mit einem Active- / Paused-Pill und einer Zusammenfassung, wie viele Felder und Filter er nutzt.
- Pause / Resume – einen Trigger vorübergehend stoppen, ohne ihn zu löschen.
- Edit – Mapping, Filter oder Ziel-Conversion ändern.
- Delete – einen einzelnen Trigger entfernen; die anderen laufen weiter.
- Weitere hinzufügen – nutze Add trigger erneut, um mehr HubSpot-Events (neue Kontakte, neue Deals, Stage-Änderungen) auf verschiedene Conversions zu mappen.
Erneut verbinden
Wenn HubSpot die App widerruft, die Event-Subscription verschwindet oder HubSpot nicht erreichbar ist, wechselt der Header auf Needs reconnect und zeigt ein Banner mit dem Grund. Klick auf Reconnect, um die Autorisierung erneut auszuführen – deine Trigger bleiben erhalten.
Trennen (Disconnect)
Um HubSpot zu entfernen, klick im Header auf Disconnect und tippe disconnect zur
Bestätigung. Das ist bewusst so, weil es destruktiv ist:
Disconnect löscht deine Trigger
Das Trennen entfernt die HubSpot-Verbindung dauerhaft, löscht jeden Trigger und widerruft die OAuth-Freigabe. HubSpot-Events fließen sofort nicht mehr in deine Conversions. Du kannst später erneut verbinden, aber deine Trigger-Konfiguration wird nicht wiederhergestellt – du richtest sie neu ein.
Fehlerbehebung
Keine Datensätze bei „Check for Data“?
Für dieses Objekt und Event ist in HubSpot noch nichts passiert. Erstelle oder ändere einen passenden Datensatz – einen neuen Kontakt, einen neuen Deal oder eine Stage-Änderung – und klick dann erneut auf Check for Data. Der passende Datensatz sollte erscheinen, sodass du das Mapping abschließen kannst.
Datensätze kommen an, werden aber keiner Kampagne zugeordnet?
LeadJourney muss wissen, zu welchem Klick der Datensatz gehört. Prüfe, dass (1) das Tracking-Script installiert ist und Klicks erfasst, (2) dein HubSpot-Formular die Click-ID auf dem Datensatz speichert und der Trigger click_id auf diese Property mappt und (3) der Trigger Active ist. Als Fallback können email oder phone zum Matchen genutzt werden.
Header zeigt „Needs reconnect“?
HubSpot hat die Freigabe widerrufen, die Subscription ist weg oder die API ist nicht erreichbar. Klick im Banner auf Reconnect, um neu zu autorisieren. Deine Trigger bleiben erhalten.
Verwandte Artikel
Cal.com verbinden
Verbinde dein Cal.com-Konto in wenigen Minuten – ohne API-Keys, ohne von Hand verdrahtete Webhooks. Einmal autorisieren, dann Buchungs-Events wie gebuchte Meetings, Verschiebungen, Stornierungen und No-Shows direkt auf deine Conversions abbilden.
Attio verbinden
Verbinde deinen Attio-Workspace in wenigen Minuten – ohne API-Keys, ohne von Hand verdrahtete Webhooks. Einmal autorisieren, dann CRM-Record-Events wie neue Personen, neue Deals, neue Unternehmen und Stage-Änderungen direkt auf deine Conversions abbilden.