Tutorials

Tutorial: HubSpot mit n8n verbinden – Schritt für Schritt

Melden

Hier ist ein ausführliches Schritt-für-Schritt-Tutorial, wie du HubSpot mit n8n verbindest.

Die Verknüpfung von HubSpot mit n8n ermöglicht es dir, CRM-Prozesse zu automatisieren, wie zum Beispiel das automatische Erstellen von Kontakten, das Synchronisieren von Deals oder das Versenden von Benachrichtigungen bei Statusänderungen.

Da HubSpot seine API-Keys eingestellt hat, nutzt man heute dafür Private Apps.

Voraussetzungen

  • Ein HubSpot-Account (Admin-Rechte erforderlich).
  • Eine laufende n8n-Instanz (Cloud oder Self-hosted).

Schritt 1: Eine Private App in HubSpot erstellen

HubSpot nutzt "Private Apps", um sicheren Zugriff auf die API zu gewähren.

  1. Logge dich in deinen HubSpot-Account ein.
  2. Klicke oben rechts auf das Zahnrad-Symbol (Einstellungen).
  3. Navigiere in der linken Seitenleiste zu Integrationen > Private Apps.
  4. Klicke auf den Button Neue private App erstellen.
  5. Gib der App einen Namen (z. B. „n8n Integration“) und optional eine Beschreibung.
  6. Wechsle zum Reiter Bereiche (Scopes). Hier legst du fest, was n8n tun darf.
    • Wähle für den Anfang unter CRM die Berechtigungen crm.objects.contacts.read und crm.objects.contacts.write (oder andere Objekte wie Deals, falls benötigt).
    • Tipp: Aktiviere nur das, was du wirklich brauchst (Prinzip der minimalen Berechtigung).
  7. Klicke oben rechts auf App erstellen.
  8. Bestätige die Sicherheitsabfrage und klicke auf Token anzeigen. Kopiere diesen Token, du wirst ihn gleich in n8n benötigen.

Schritt 2: Credentials in n8n einrichten

Nun hinterlegen wir den Zugriffsschlüssel in n8n, damit er für alle Workflows verfügbar ist.

  1. Öffne deine n8n-Benutzeroberfläche.
  2. Klicke in der linken Seitenleiste auf Credentials (Anmeldedaten).
  3. Klicke oben rechts auf Add Credential (Anmeldedaten hinzufügen).
  4. Suche nach HubSpot und wähle HubSpot Access Token API aus.
  5. Gib der Verbindung einen Namen (z. B. „HubSpot Mein Unternehmen“).
  6. Füge den Access Token, den du in HubSpot kopiert hast, in das Feld ein.
  7. Klicke auf Save (Speichern). Wenn alles korrekt ist, erscheint ein grüner Haken mit „Connection tested“.

Schritt 3: Die Verbindung testen (Erster Workflow)

Lass uns prüfen, ob n8n tatsächlich Daten von HubSpot abrufen kann.

  1. Gehe in n8n auf Workflows und erstelle einen neuen Workflow.
  2. Klicke auf das +, um einen Node hinzuzufügen.
  3. Suche nach dem HubSpot Node.
  4. Wähle unter Credential for HubSpot die gerade erstellten Anmeldedaten aus.
  5. Wähle als Resource zum Beispiel Contact und als Operation Get Many (oder Get All).
  6. Klicke auf den Button Execute Node (Node ausführen).
  7. Wenn die Verbindung steht, siehst du nun im rechten Fenster die Liste deiner HubSpot-Kontakte im JSON-Format.

Häufige Fehler und Tipps

  • Permissions (Scopes): Wenn du eine Fehlermeldung wie „Forbidden“ oder „403“ erhältst, hast du in der Private App in HubSpot wahrscheinlich nicht die richtigen Scopes (Berechtigungen) aktiviert. Gehe zurück zur App in HubSpot und füge die fehlenden Scopes hinzu.
  • Webhooks: Wenn du möchtest, dass HubSpot n8n sofort informiert, wenn etwas passiert (z. B. ein neuer Kontakt wird erstellt), kannst du den HubSpot Trigger Node verwenden. Dafür benötigt deine n8n-Instanz jedoch eine öffentlich erreichbare URL (HTTPS).
  • Sicherheit: Gib den Access Token niemals an Dritte weiter. Falls der Token kompromittiert wurde, kannst du ihn in HubSpot jederzeit unter den Private App Einstellungen rotieren (erneuern) oder löschen.

Zusammenfassung

Die Verbindung steht! Du kannst nun HubSpot-Daten als Startpunkt für komplexe Automatisierungen nutzen oder Daten aus anderen Tools (wie Google Sheets, Slack oder Datenbanken) direkt in dein HubSpot CRM schreiben.

0