Du verbindest n8n mit HubSpot über einen Private App Token: In HubSpot legst du eine Private App mit den nötigen Scopes an, in n8n hinterlegst du den Token als Credential vom Typ "HubSpot API". Danach lesen und schreiben die HubSpot-Nodes in n8n deine Kontakte, Unternehmen und Deals. n8n ist eine self-hosted Workflow-Automation und übernimmt die Aufgaben, bei denen HubSpot Workflows an Grenzen stoßen. Hier siehst du das Setup, einen Workflow zur automatischen Lead-Qualifizierung und die Anbindung externer Datenquellen. Zapier oder Make brauchst du dafür nicht.
Die n8n HubSpot Verbindung läuft über einen Private App Token: In HubSpot legst du eine Private App mit den nötigen Scopes an, in n8n hinterlegst du den Token als Credential vom Typ „HubSpot API“. Das Setup dauert etwa 10 Minuten. Danach lesen und schreiben die HubSpot-Nodes Kontakte, Unternehmen und Deals.
- Für Kontakte mindestens Lese- und Schreib-Scope vergeben
- Bulk-Aktionen in 100er-Batches wegen der Rate-Limits
- Error-Trigger in jedem produktiven Workflow
Was ist n8n und warum brauchst du es neben HubSpot?
n8n ist eine Open-Source-Workflow-Automation, die du auf deinem eigenen Server betreiben kannst. Bei Zapier oder Make zahlst du pro Task. n8n hostest du selbst, auf einem VPS, einem Kubernetes-Cluster oder lokal per Docker. Damit bleiben die Daten bei dir (relevant für die DSGVO), und die Kosten steigen nicht linear mit dem Volumen.
Die HubSpot Workflows sind an das CRM gebunden und sprechen nur bedingt mit externen Systemen. Sobald du Daten aus einer Datenbank ziehen, eine Fremd-API abfragen oder mehrere Schritte mit komplexer Logik verknüpfen willst, wird es in HubSpot umständlich. Diese Aufgaben übernimmt n8n und nutzt dafür die HubSpot API als Schnittstelle.
Kernidee: n8n ergänzt die HubSpot Workflows. Einfache CRM-Automationen bleiben in HubSpot, komplexe Integrationen und Enrichment laufen in n8n.
Wie funktioniert die HubSpot API für n8n?
Die HubSpot API ist eine REST-Schnittstelle, über die du auf alle CRM-Objekte zugreifen kannst: Kontakte, Unternehmen, Deals, Tickets, Produkte und benutzerdefinierte Objekte. Jeder Endpunkt folgt dem gleichen Muster: GET zum Lesen, POST zum Anlegen, PATCH zum Aktualisieren. Authentifiziert wird über einen Private App Token, den du direkt in HubSpot unter Einstellungen → Integrationen → Private Apps erstellst.
Für die Verbindung mit n8n reicht dieser Token. Du definierst beim Anlegen der Private App die Scopes (also Lese- und Schreibrechte pro Objekt) und bekommst danach einen Bearer-Token, den du in n8n als Credential hinterlegst. Wenn du dich mit den verfügbaren Endpunkten noch nicht auskennst, hilft ein HubSpot Audit dabei, die richtigen Scopes und Datenflüsse zu definieren.
Wie verbinde ich n8n mit HubSpot?
n8n verbindest du mit HubSpot, indem du in HubSpot eine Private App anlegst und ihren Token in n8n als Credential hinterlegst. Das Setup dauert etwa 10 Minuten. Zuerst legst du in HubSpot eine Private App mit den benötigten Scopes an. Für die Lead-Qualifizierung brauchst du mindestens crm.objects.contacts.read und crm.objects.contacts.write. Kopiere den generierten Token und öffne dein n8n-Dashboard. Dort legst du ein neues Credential vom Typ "HubSpot API" an und fügst den Token ein.
Verbindung in vier Schritten
- 1Private AppIn HubSpot anlegen
- 2ScopesLese- und Schreibrechte wählen
- 3TokenGenerierten Token kopieren
- 4CredentialTyp „HubSpot API“ in n8n
n8n liefert fertige HubSpot-Nodes mit. Damit suchst, legst an, aktualisierst oder löschst du Kontakte, ohne selbst HTTP-Requests zu bauen. Für Endpunkte, die n8n nativ nicht abdeckt (zum Beispiel bestimmte Reporting-APIs), nutzt du den HTTP-Request-Node und hängst den Token im Authorization-Header an. So arbeiten wir auch in unserem HubSpot Setup bei größeren Automationsprojekten.
| Komponente | Aufgabe | Scope-Beispiel |
|---|---|---|
| Private App Token | Authentifizierung in n8n | crm.objects.contacts.write |
| HubSpot Trigger Node | Events aus HubSpot empfangen | Webhook-basiert |
| HubSpot Action Node | Kontakte & Deals schreiben | contacts.write, deals.write |
| HTTP Request Node | Custom-Endpunkte ansprechen | Bearer Token im Header |
Wie qualifiziere ich HubSpot Leads automatisch mit n8n?
Leads qualifizierst du mit n8n über einen Workflow, der neue HubSpot Kontakte mit externen Firmendaten anreichert und danach den Lifecycle-Status setzt. Typisches Szenario: Ein neuer Kontakt wird über ein HubSpot Formular angelegt. Vor der Übergabe an Sales soll automatisch geprüft werden, ob die Firma relevant ist, etwa nach Mindestmitarbeiterzahl, Branche und Region. In HubSpot kannst du das teilweise über Lead Scoring lösen, aber sobald externe Datenquellen ins Spiel kommen, wird es unflexibel.
Lead Qualifizierung mit n8n
- 1TriggerContact Created in HubSpot
- 2AnreicherungFirmendaten per API abfragen
- 3UpdateMQL oder Disqualified setzen
In n8n baust du dafür einen Workflow mit drei Schritten: 1. HubSpot Trigger lauscht auf "Contact Created". 2. HTTP-Node fragt die Firmendaten über eine Anreicherungs-API ab (z.B. Clearbit, Hunter.io, Apollo). 3. HubSpot-Action-Node aktualisiert den Kontakt und setzt den Lifecycle-Status je nach Ergebnis der Prüfung auf "MQL" oder "Disqualified".
Im Vergleich zu einer reinen HubSpot-Lösung baust du Conditional Logic, externe Lookups und Retries zentral in einem Flow. Fehler landen in einem Error-Branch, den du zum Beispiel an Slack oder eine HubSpot-Liste mit manueller Review weiterreichst.
HubSpot + n8n einrichten lassen?
Wir bauen dir die komplette Strecke, von der Private App bis zum produktiven n8n-Workflow.
Jetzt beraten lassenWie reichere ich HubSpot-Kontakte mit externen Daten an?
Externe Daten ergänzt du in HubSpot-Kontakten per n8n-Enrichment, dem zweiten häufigen Use-Case für n8n. Ein typisches Szenario: Ein Kontakt kommt mit Name und E-Mail rein, aber ohne Firmeninformationen. Du willst automatisch Firmenname, Mitarbeiterzahl, Branche und LinkedIn-URL ergänzen. In n8n baust du dafür einen Workflow, der per Schedule-Trigger (z.B. jede Stunde) alle Kontakte ohne Firmenzuordnung aus HubSpot holt, über eine externe API anreichert und die Ergebnisse zurückschreibt.
Nutze dabei immer Batching. Die HubSpot API erlaubt bis zu 100 Records pro Request, und n8n hat dafür den Split in Batches-Node, der deine Inputs automatisch aufteilt. So bleibst du unterhalb der Rate-Limits (standardmäßig 100 Requests / 10 Sekunden pro Private App) und vermeidest 429-Fehler. Wenn du Kontakte aus verschiedenen Quellen zusammenführst, kann es außerdem sinnvoll sein, vorab auf Duplikate zu prüfen.
Welche Fehler solltest du bei n8n + HubSpot vermeiden?
Der häufigste Fehler ist fehlendes Error-Handling. Wenn die externe API einen 500er zurückgibt, stoppt der Workflow und du merkst es erst, wenn sich Kontakte stauen. Richte deshalb in jedem produktiven n8n-Workflow einen Error-Trigger ein, der dich per E-Mail oder Slack benachrichtigt. Der zweite häufige Fehler ist fehlendes Logging. Ohne Execution-History weißt du nach einem Monat nicht mehr, welcher Kontakt durch welchen Workflow gelaufen ist.
Auch Rate-Limits werden oft unterschätzt. Wenn du 10.000 Kontakte auf einmal enrichst, ohne Split in Batches und ohne Wait-Nodes einzubauen, bekommst du schnell 429-Fehler und einen temporären Block der Private App. Plane jede Bulk-Aktion mit 100er-Batches und mindestens 2 Sekunden Wait dazwischen. Teste außerdem jeden Workflow erst gegen ein Testobjekt in HubSpot, bevor du ihn scharfschaltest.
Die HubSpot Agent Hub Kosten im Vergleich mit n8n haben wir mit echten Testläufen und Screenshots nachgerechnet. Der Artikel zeigt Verbrauch, Inklusivcredits und die zusätzlichen Betriebskosten.
Fazit: n8n als Turbo für dein HubSpot-Setup
n8n passt zu HubSpot, wenn deine Workflows über das CRM hinausgehen. Die HubSpot API ist stabil und gut dokumentiert, die nativen n8n-Nodes nehmen dir den größten Teil der Arbeit ab, und durch das Self-hosting bleiben deine Daten bei dir. Einfache Automationen baust du weiter in HubSpot. Sobald mehrere Systeme, externe APIs oder komplexe Logik im Spiel sind, wechselst du zu n8n.
Quick-Start-Empfehlung: Lege eine Private App mit minimalem Scope an, installiere n8n per Docker auf einem kleinen VPS und baue deinen ersten Workflow aus drei Schritten: Contact Created, Enrichment, Lifecycle-Update. Das schaffst du an einem Nachmittag und erweiterst es danach Schritt für Schritt.
Häufige Fragen zu HubSpot und n8n
Was ist n8n und wie unterscheidet es sich von Zapier?
n8n ist eine Open-Source-Workflow-Automation, die du self-hosted auf deinem eigenen Server betreibst. Bei Zapier zahlst du pro Task, bei n8n nur die Server-Kosten. Außerdem bleiben deine Daten bei dir, was bei DSGVO-kritischen Use-Cases hilft.
Wie verbinde ich n8n mit der HubSpot API?
Du legst in HubSpot unter Einstellungen → Integrationen → Private Apps eine neue App mit den benötigten Scopes an. Den generierten Token hinterlegst du in n8n als HubSpot-API-Credential. Danach kannst du die nativen HubSpot-Nodes oder den HTTP-Request-Node mit Bearer-Auth nutzen.
Gibt es einen fertigen HubSpot Node in n8n?
Ja. n8n liefert fertige HubSpot-Nodes mit, mit denen du Kontakte suchst, anlegst, aktualisierst oder löschst, ohne selbst HTTP-Requests zu bauen. Dazu kommt ein HubSpot Trigger, der zum Beispiel auf „Contact Created“ reagiert. Für Endpunkte, die n8n nativ nicht abdeckt, nutzt du den HTTP-Request-Node mit dem Token im Authorization-Header.
Welche Rate-Limits hat die HubSpot API?
Private Apps haben ein Standard-Limit von 100 Requests pro 10 Sekunden und 250.000 Requests pro Tag. Nutze Split in Batches in n8n, um unter diesen Grenzen zu bleiben und 429-Fehler zu vermeiden.
Kann ich mit n8n auch Deals und Unternehmen aktualisieren?
Ja. Die HubSpot-Nodes in n8n unterstützen alle Standard-Objekte: Kontakte, Unternehmen, Deals, Tickets und Produkte. Benutzerdefinierte Objekte sprichst du über den HTTP-Request-Node an. Du brauchst dafür die passenden Scopes in deiner Private App.
Brauche ich einen eigenen Server für n8n?
Ja, für produktive Setups. n8n läuft als Docker-Container auf einem kleinen VPS (ab ca. 10 € im Monat, je nach Anbieter) oder einem Kubernetes-Cluster. Alternativ gibt es n8n Cloud als gehostete Variante, wenn du kein eigenes Hosting betreiben willst.
Was passiert bei einem Fehler im n8n-Workflow?
Standardmäßig stoppt der Workflow an der Fehlerstelle. In produktiven Setups baust du einen Error-Trigger ein, der dich bei Fehlern benachrichtigt und die fehlgeschlagene Execution archiviert. So verlierst du keine Kontakte, auch wenn eine externe API kurzzeitig ausfällt.
Ersetzt n8n die HubSpot Workflows?
Nein. Einfache CRM-interne Automationen bleiben in HubSpot, weil sie dort schneller eingerichtet und gewartet sind. n8n übernimmt komplexe Integrationen, Enrichment und alles, was mehrere externe Systeme verbindet.
