HubSpot-Workflows sind mächtig — aber an manchen Stellen stoßen sie an Grenzen. Genau dort kommt n8n ins Spiel: Eine self-hosted Workflow-Automation, die du über die HubSpot API anbindest und damit Dinge automatisierst, die HubSpot nativ nicht kann. In diesem Artikel zeigen wir dir, wie du n8n mit HubSpot verbindest, Leads automatisch qualifizierst und externe Datenquellen anbindest — ohne dich auf Zapier oder Make festzulegen.
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. Im Gegensatz zu Zapier oder Make zahlst du nicht pro Task, sondern hostest die Plattform selbst — auf einem VPS, einem Kubernetes-Cluster oder lokal per Docker. Das hat zwei große Vorteile: Die Datenhoheit bleibt bei dir (wichtig für DSGVO), und die Kosten skalieren nicht linear mit dem Volumen.
Warum du n8n trotz der mächtigen HubSpot Workflows brauchst: HubSpot-Workflows sind an das CRM gebunden und können nur bedingt mit externen Systemen sprechen. 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. n8n übernimmt diese Rolle und nutzt die HubSpot API als Schnittstelle — du bekommst die Stärken beider Welten.
Kernidee: n8n ersetzt HubSpot-Workflows nicht — es ergänzt sie. Einfache CRM-Automationen bleiben in HubSpot, komplexe Integrationen und Enrichment laufen in n8n.
Wie funktioniert die HubSpot API?
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 vollkommen aus. 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?
Das Setup dauert etwa 10 Minuten. Zuerst legst du in HubSpot eine Private App mit den benötigten Scopes an — für 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.
n8n liefert fertige HubSpot-Nodes mit: Du kannst Kontakte suchen, anlegen, aktualisieren oder löschen, ohne dich mit HTTP-Requests beschäftigen zu müssen. 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. Genau dieser Ansatz ist auch das Rückgrat unseres HubSpot Setups bei komplexeren Automations-Projekten.
| 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 Leads automatisch mit n8n?
Typisches Szenario: Ein neuer Kontakt wird über ein HubSpot Formular angelegt. Du willst vor der Übergabe an Sales automatisch prüfen, ob die Firma überhaupt relevant ist — Mindestmitarbeiterzahl, Branche, Region. In HubSpot kannst du das teilweise über Lead Scoring lösen, aber sobald externe Datenquellen ins Spiel kommen, wird es unflexibel.
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 auf "MQL" oder "Disqualified" — je nach Ergebnis der Prüfung.
Der Vorteil gegenüber einer reinen HubSpot-Lösung: Du kannst Conditional Logic, externe Lookups und Retries zentral in einem Flow bauen. 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 Pipeline — von der Private App bis zum produktiven n8n-Workflow.
Jetzt beraten lassenWie reichere ich HubSpot-Kontakte mit externen Daten an?
Enrichment ist der zweite große Use-Case für n8n. Klassisches 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.
Wichtig dabei: Nutze immer Batching. Die HubSpot API erlaubt bis zu 100 Records pro Request — 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: Kein Error-Handling. Wenn die externe API mal 500 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. Ein zweiter klassischer 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. Und: Teste jeden Workflow erst gegen ein Testobjekt in HubSpot, bevor du ihn scharfschaltest.
Fazit: n8n als Turbo für dein HubSpot-Setup
n8n ist die perfekte Ergänzung zu HubSpot, wenn du Workflows über die CRM-Grenze hinaus denken willst. Die HubSpot API ist stabil und gut dokumentiert, die nativen n8n-Nodes nehmen dir die meiste Arbeit ab, und dank Self-hosting bleiben deine Daten bei dir. Für einfache Automationen bleibst du in HubSpot — für alles, was mehrere Systeme, externe APIs oder komplexe Logik braucht, 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: "Contact Created → Enrichment → Lifecycle-Update". Damit hast du in einem Nachmittag ein funktionierendes Setup und kannst es Schritt für Schritt erweitern.
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. Im Gegensatz zu Zapier zahlst du nicht pro Task, sondern nur die Server-Kosten. Außerdem bleiben deine Daten bei dir, was gerade für DSGVO-kritische Use-Cases entscheidend ist.
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.
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, Produkte — sowie benutzerdefinierte Objekte über den HTTP-Request-Node. Du brauchst lediglich 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€/Monat) 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.
