HubSpot Integrationen: API und Marketplace für KMU

Einleitung: Warum Integrationen für KMU unverzichtbar sind

Du nutzt HubSpot als CRM, verschickst Newsletter, trackst Deals und verwaltest deine Kontakte. Aber daneben gibt es noch deine Buchhaltungssoftware, dein Projektmanagement-Tool, deinen Online-Shop, vielleicht ein Ticketsystem und mindestens drei weitere Anwendungen, die im Alltag unverzichtbar sind. Und genau hier liegt das Problem: Wenn diese Systeme nicht miteinander sprechen, entsteht ein Flickenteppich aus Dateninseln.

Für kleine und mittlere Unternehmen ist das besonders kritisch. Du hast kein zehnköpfiges IT-Team, das Daten manuell abgleicht. Wenn dein Vertrieb einen Deal in HubSpot abschließt, muss die Rechnung automatisch in der Buchhaltung landen. Wenn ein Kunde im Shop bestellt, muss der Kontakt im CRM aktualisiert werden. Wenn ein Ticket eskaliert wird, muss der zuständige Account Manager sofort Bescheid wissen.

Integrationen sind kein Nice-to-have mehr – sie sind die Grundlage dafür, dass dein Unternehmen effizient arbeiten kann. Die gute Nachricht: HubSpot bietet dir gleich mehrere Wege, diese Verbindungen herzustellen. Vom einfachen Marketplace-App-Install über Middleware-Plattformen wie Zapier oder Make bis hin zu maßgeschneiderten API-Integrationen. Welcher Weg für dich der richtige ist, hängt von deinem Use Case, deinem Budget und deinen technischen Ressourcen ab.

In diesem Guide schauen wir uns alle Optionen im Detail an. Ich zeige dir, wie du die richtigen Marketplace-Apps findest, wann du besser auf die API setzt, wie du Private Apps erstellst und welche Integrationen sich in der Praxis für KMU besonders bewährt haben. Los geht's.

HubSpot Marketplace: Die besten Apps finden und bewerten

Der HubSpot App Marketplace ist deine erste Anlaufstelle, wenn du eine Integration suchst. Mit über 1.500 verfügbaren Apps deckt er die meisten Standard-Anwendungsfälle ab – von E-Mail-Marketing über Buchhaltung bis hin zu Projektmanagement und E-Commerce.

So navigierst du den Marketplace

Du erreichst den Marketplace direkt über dein HubSpot-Konto unter App Marketplace in der oberen Navigation oder über ecosystem.hubspot.com/marketplace/apps. Die Apps sind in Kategorien sortiert: Sales, Marketing, Customer Service, Productivity, Finance und viele mehr. Nutze die Filterfunktion, um nach deinem HubSpot-Plan zu filtern – nicht jede App funktioniert mit der kostenlosen Version.

Worauf du bei der App-Bewertung achten solltest

Nicht jede App im Marketplace ist gleich gut. Bevor du eine App installierst, prüfe folgende Kriterien:

• Bewertungen und Rezensionen: Schau dir nicht nur die Durchschnittsnote an, sondern lies die aktuellsten Bewertungen. Eine App mit 4,5 Sternen aus dem Jahr 2021 kann heute komplett veraltet sein. Achte besonders auf Beschwerden zu fehlerhaften Syncs, fehlendem Support oder plötzlichen Preiserhöhungen.
• Anzahl der Installationen: Eine App mit 10.000+ Installationen hat sich in der Praxis bewiesen. Apps mit unter 100 Installationen können funktionieren, bergen aber ein höheres Risiko, dass der Anbieter den Support irgendwann einstellt.
• Datenfluss-Richtung: Synchronisiert die App bidirektional (Daten fließen in beide Richtungen) oder nur unidirektional? Für die meisten Anwendungsfälle brauchst du eine bidirektionale Synchronisation, damit Änderungen in beiden Systemen reflektiert werden.
• Berechtigungen (Scopes): Welche Zugriffsrechte fordert die App? Eine Kalender-Integration, die Zugriff auf deine Deals verlangt, sollte dich stutzig machen. Prüfe die angeforderten Scopes sorgfältig.
• Pricing: Viele Marketplace-Apps haben ein Freemium-Modell. Die kostenlose Version synchronisiert vielleicht 100 Kontakte, aber für den vollen Funktionsumfang zahlst du 50 bis 200 Euro pro Monat. Kläre das Pricing, bevor du die App in deine Prozesse einbaust.

Native Integrationen vs. Drittanbieter vs. Custom API

Bei HubSpot-Integrationen gibt es grundsätzlich drei Wege, die sich in Aufwand, Flexibilität und Kosten deutlich unterscheiden. Welcher Weg der richtige ist, hängt von deinem konkreten Anwendungsfall ab.

Native Integrationen (von HubSpot gebaut)

HubSpot bietet für die wichtigsten Tools eigene, native Integrationen an. Dazu gehören unter anderem Gmail, Outlook, Slack, Zoom, WordPress und Shopify. Diese Integrationen werden direkt von HubSpot entwickelt und gepflegt, was bedeutet: Sie sind in der Regel stabil, gut dokumentiert und werden bei HubSpot-Updates zeitnah angepasst.

Der Nachteil: Native Integrationen decken meist nur Standard-Use-Cases ab. Wenn du einen speziellen Datenfluss brauchst – zum Beispiel nur bestimmte Kontakte synchronisieren oder Custom Properties mappen – stoßen native Integrationen schnell an ihre Grenzen.

Drittanbieter-Integrationen (Marketplace-Apps und Middleware)

Marketplace-Apps von Drittanbietern bieten oft mehr Konfigurationsmöglichkeiten als native Integrationen. Dazu kommen Middleware-Plattformen wie Zapier, Make (ehemals Integromat) und n8n, mit denen du ohne Programmierung eigene Workflows zwischen HubSpot und praktisch jedem anderen Tool bauen kannst.

Zapier und Make sind ideal für einfache bis mittlere Integrationen: Wenn ein neuer Deal in HubSpot erstellt wird, erstelle eine Aufgabe in Asana. Wenn ein Formular ausgefüllt wird, sende eine Nachricht in Slack. Solche Workflows sind in wenigen Minuten eingerichtet und kosten je nach Volumen zwischen 20 und 100 Euro pro Monat.

Der Nachteil von Middleware: Du bist von einem zusätzlichen Anbieter abhängig. Wenn Zapier ausfällt oder sein Pricing ändert, betrifft das alle deine Integrationen. Außerdem kann es bei hohem Datenvolumen teuer werden, weil die meisten Middleware-Plattformen nach Anzahl der Ausführungen (Tasks/Operations) abrechnen.

Custom API-Integrationen

Wenn native Integrationen und Middleware nicht reichen, bleibt die Custom-API-Integration. Hier baust du (oder ein Entwickler) eine maßgeschneiderte Anbindung über die HubSpot-API. Das gibt dir maximale Flexibilität: Du bestimmst exakt, welche Daten wann und wie synchronisiert werden, welche Transformationen stattfinden und wie mit Fehlern umgegangen wird.

Der Nachteil: Custom-Integrationen erfordern Entwicklungsressourcen, müssen gewartet werden und sind anfällig für Breaking Changes bei API-Updates. Für KMU lohnt sich eine Custom-Integration erst dann, wenn der Use Case wirklich spezifisch ist und sich nicht mit Marketplace-Apps oder Middleware abbilden lässt.

HubSpot API im Überblick: REST, OAuth und Rate Limits

Falls du dich für den API-Weg entscheidest – oder einfach verstehen willst, wie Integrationen unter der Haube funktionieren – hier die wichtigsten Grundlagen der HubSpot-API.

REST-Architektur und Endpunkte

Die HubSpot-API folgt dem REST-Prinzip (Representational State Transfer). Das bedeutet: Du kommunizierst über Standard-HTTP-Methoden mit den API-Endpunkten. Die wichtigsten Methoden sind:

• GET: Daten abrufen (z.B. einen Kontakt lesen)
• POST: Neue Datensätze erstellen (z.B. einen Deal anlegen)
• PATCH: Bestehende Datensätze aktualisieren (z.B. eine E-Mail-Adresse ändern)
• DELETE: Datensätze löschen

Die Basis-URL für alle API-Anfragen lautet https://api.hubapi.com. Ein typischer Endpunkt zum Abrufen eines Kontakts sieht so aus: GET https://api.hubapi.com/crm/v3/objects/contacts/{contactId}. Die Antwort kommt als JSON zurück und enthält alle Properties des Kontakts, die du über den properties-Parameter angefordert hast.

HubSpot strukturiert seine API in verschiedene Bereiche: CRM (Contacts, Companies, Deals, Tickets), Marketing (E-Mails, Forms, Lists), CMS (Pages, Blog Posts) und Automation (Workflows). Jeder Bereich hat eigene Endpunkte, die in der offiziellen API-Dokumentation ausführlich beschrieben sind.

Authentifizierung: OAuth 2.0 und Private App Tokens

Für die Authentifizierung bietet HubSpot zwei Methoden an:

• OAuth 2.0: Der Standard für öffentliche Apps, die von mehreren HubSpot-Portalen genutzt werden. Der Nutzer autorisiert die App über einen Login-Flow, und die App erhält ein Access Token mit definierten Scopes. Access Tokens laufen nach 30 Minuten ab und müssen über ein Refresh Token erneuert werden.
• Private App Tokens: Die einfachere Methode für interne Integrationen. Du erstellst eine Private App in deinem HubSpot-Konto, definierst die benötigten Scopes und erhältst ein dauerhaftes Access Token. Dieses Token sendest du im Header jeder API-Anfrage mit: Authorization: Bearer {dein-token}.

Für KMU-interne Integrationen sind Private App Tokens die richtige Wahl. Sie sind einfacher einzurichten, erfordern keinen OAuth-Flow und das Token läuft nicht ab (solange du es nicht widerrufst). OAuth brauchst du nur, wenn du eine App baust, die von anderen HubSpot-Nutzern installiert werden soll.

Rate Limits: Wie viel darf ich anfragen?

HubSpot limitiert die Anzahl der API-Anfragen, die du pro Zeitraum senden darfst. Die aktuellen Limits sind:

• Private Apps: 200 Anfragen pro Sekunde pro App (für die meisten KMU-Anwendungsfälle mehr als ausreichend)
• OAuth-Apps: 200 Anfragen pro Sekunde pro Portal
• Tägliches Limit: Abhängig von deinem HubSpot-Plan. Free und Starter haben ein niedrigeres Limit als Professional und Enterprise.

Wenn du das Rate Limit überschreitest, antwortet die API mit dem HTTP-Statuscode 429 Too Many Requests. Dein Code sollte diesen Fall abfangen und die Anfrage nach einer kurzen Wartezeit wiederholen (Retry mit Exponential Backoff). In der Praxis erreichst du die Rate Limits als KMU selten – es sei denn, du baust einen initialen Datenimport, der tausende Datensätze auf einmal synchronisiert.

Private Apps erstellen: Schritt-für-Schritt-Anleitung

Private Apps sind der schnellste Weg, um eine eigene Integration mit der HubSpot-API aufzubauen. Hier zeige ich dir Schritt für Schritt, wie du eine Private App erstellst und dein erstes API-Request sendest.

Schritt 1: Private App in HubSpot anlegen

Gehe in deinem HubSpot-Konto zu Settings > Integrations > Private Apps und klicke auf Create a private app. Vergib einen aussagekräftigen Namen – zum Beispiel "Buchhaltung-Sync" oder "Shop-Integration". Füge eine Beschreibung hinzu, damit dein Team weiß, wofür die App verwendet wird.

Schritt 2: Scopes definieren

Im Tab Scopes legst du fest, auf welche HubSpot-Daten die App zugreifen darf. Wähle nur die Scopes, die du tatsächlich brauchst. Typische Scopes sind:

• crm.objects.contacts.read und crm.objects.contacts.write für Kontakte
• crm.objects.deals.read und crm.objects.deals.write für Deals
• crm.objects.companies.read für Unternehmen
• crm.schemas.contacts.read um Custom Properties auszulesen

Je weniger Scopes du vergibst, desto sicherer ist deine Integration. Wenn die App nur Kontaktdaten lesen soll, gib ihr keinen Schreibzugriff auf Deals.

Schritt 3: Token generieren und sicher speichern

Klicke auf Create app. HubSpot generiert jetzt ein Access Token für dich. Kopiere dieses Token und speichere es sicher – zum Beispiel in einem Passwort-Manager oder als Umgebungsvariable in deiner Anwendung. Speichere das Token niemals im Quellcode oder in einem Git-Repository.

Schritt 4: Erstes API-Request testen

Teste deine Private App mit einem einfachen GET-Request. Du kannst dafür ein Tool wie Postman oder curl verwenden. Hier ein Beispiel mit curl, um deine Kontakte abzurufen:

curl https://api.hubapi.com/crm/v3/objects/contacts --header "Authorization: Bearer DEIN_TOKEN"

Wenn alles korrekt eingerichtet ist, bekommst du eine JSON-Antwort mit deinen Kontaktdaten zurück. Ab hier kannst du die Integration in deiner bevorzugten Programmiersprache weiterentwickeln. HubSpot bietet offizielle Client-Libraries für Node.js, Python, Ruby und PHP an, die dir das Leben deutlich einfacher machen.

Praxisbeispiel: HubSpot + Buchhaltung (DATEV/lexoffice)

Die Verbindung zwischen CRM und Buchhaltung ist für deutsche KMU einer der wichtigsten Integrations-Use-Cases. Wenn dein Vertrieb einen Deal in HubSpot abschließt, soll die Rechnung möglichst automatisch erstellt werden – ohne dass jemand die Daten manuell in die Buchhaltungssoftware überträgt.

HubSpot + lexoffice

Für lexoffice gibt es im HubSpot Marketplace mehrere Integrationen. Die gängigste Variante nutzt Zapier oder Make als Middleware. Der typische Workflow sieht so aus:

• Trigger: Deal-Status in HubSpot ändert sich auf "Closed Won"
• Aktion 1: Kontaktdaten und Deal-Informationen aus HubSpot abrufen
• Aktion 2: Rechnung in lexoffice erstellen mit den Daten aus dem Deal (Produkte, Mengen, Preise, Kundendaten)
• Aktion 3: Rechnungsnummer zurück in HubSpot schreiben (als Custom Property am Deal)

So hast du eine lückenlose Verbindung: Dein Vertrieb arbeitet ausschließlich in HubSpot, die Buchhaltung findet die Rechnung automatisch in lexoffice vor. Kein Copy-Paste, keine vergessenen Rechnungen, keine Fehler bei der Datenübertragung.

HubSpot + DATEV

Die DATEV-Integration ist etwas komplexer, weil DATEV traditionell keine offene API im klassischen Sinne anbietet. Hier gibt es mehrere Ansätze:

• DATEV Unternehmen online: Über die DATEV-Schnittstelle können Buchungsdaten als CSV oder XML exportiert und importiert werden. Eine Middleware wie Make kann diesen Export automatisieren.
• Drittanbieter-Konnektoren: Es gibt spezialisierte Anbieter, die sich auf die Verbindung zwischen Cloud-CRMs und DATEV spezialisiert haben. Diese übernehmen das Mapping der Datenfelder und stellen sicher, dass die Buchungssätze DATEV-konform sind.
• Custom-Integration über DATEV-APIs: DATEV bietet mittlerweile moderne APIs über die DATEV Developer-Plattform an. Diese erfordern eine Registrierung und Freischaltung, bieten dann aber standardisierte REST-Endpunkte für Buchungsdaten.

Praxisbeispiel: HubSpot + Projektmanagement (Asana/Monday)

Wenn dein Vertrieb einen Deal gewinnt, beginnt die eigentliche Arbeit: Das Projekt muss aufgesetzt, Aufgaben müssen verteilt und Deadlines festgelegt werden. Statt diese Informationen manuell vom CRM ins Projektmanagement-Tool zu übertragen, kannst du diesen Prozess automatisieren.

HubSpot + Asana

Für die HubSpot-Asana-Integration gibt es eine native Marketplace-App von Asana selbst. Sie ermöglicht es dir, direkt aus HubSpot heraus Asana-Aufgaben zu erstellen und den Status von Projekten einzusehen. Für fortgeschrittene Workflows nutzt du Zapier oder Make:

• Deal gewonnen → Projekt erstellen: Wenn ein Deal in HubSpot auf "Closed Won" wechselt, wird automatisch ein Asana-Projekt erstellt. Die Projektvorlage in Asana enthält alle Standard-Aufgaben (Kick-off planen, Anforderungen dokumentieren, Zugänge einrichten etc.), die automatisch dem richtigen Team zugewiesen werden.
• Kontaktdaten synchronisieren: Der Kundenname, die Kontaktperson und die Deal-Details werden als Beschreibung ins Asana-Projekt übernommen, sodass das Projektteam alle relevanten Informationen hat, ohne HubSpot öffnen zu müssen.
• Status-Updates zurückspielen: Wenn alle Aufgaben in Asana abgeschlossen sind, wird der Deal in HubSpot automatisch auf eine neue Pipeline-Stage (z.B. "Projekt abgeschlossen") gesetzt.

HubSpot + Monday.com

Monday.com bietet ebenfalls eine native HubSpot-Integration im Marketplace an. Die Einrichtung ist unkompliziert: Du verbindest beide Konten, wählst die Boards und Spalten aus, die du synchronisieren möchtest, und legst Sync-Regeln fest. Monday bietet dabei eine besonders flexible Spaltenzuordnung an – du kannst HubSpot Custom Properties direkt auf Monday-Spalten mappen.

Ein häufiger Use Case für die Monday-HubSpot-Integration: Das Vertriebsteam arbeitet in HubSpot, das Delivery-Team in Monday. Über die Integration sieht das Delivery-Team automatisch alle gewonnenen Deals mit den relevanten Details und kann sofort mit der Umsetzung starten. Statusänderungen in Monday werden zurück nach HubSpot gespielt, sodass der Vertrieb den Projektstatus im CRM verfolgen kann.

Praxisbeispiel: HubSpot + E-Commerce (Shopify/WooCommerce)

Für E-Commerce-Unternehmen ist die Verbindung zwischen Shop und CRM essentiell. Du willst wissen, welche Kontakte was gekauft haben, um personalisierte Marketing-Kampagnen aufzusetzen und den Customer Lifetime Value zu tracken.

HubSpot + Shopify

Die HubSpot-Shopify-Integration gehört zu den besten nativen Integrationen im Marketplace. Sie synchronisiert automatisch:

• Kunden: Shopify-Kunden werden als Kontakte in HubSpot angelegt und fortlaufend aktualisiert. E-Mail, Name, Adresse und Telefonnummer werden automatisch gemappt.
• Bestellungen: Jede Shopify-Bestellung wird als Deal in HubSpot erstellt. Produkte, Bestellwert, Rabatte und Versandstatus sind als Properties am Deal hinterlegt.
• Warenkorbabbrecher: Kontakte, die einen Warenkorb befüllt, aber nicht ausgecheckt haben, werden automatisch in HubSpot getaggt. So kannst du gezielte Abandoned-Cart-E-Mails über HubSpot-Workflows versenden.
• Produkte: Dein Shopify-Produktkatalog wird mit der HubSpot-Produktbibliothek synchronisiert.

Besonders mächtig wird die Integration in Kombination mit HubSpot-Workflows: Du kannst automatische E-Mail-Sequenzen basierend auf Kaufverhalten auslösen – zum Beispiel eine Cross-Selling-Mail 14 Tage nach dem Kauf oder eine Nachbestellungserinnerung nach 90 Tagen.

HubSpot + WooCommerce

Für WooCommerce gibt es keine native HubSpot-Integration, aber mehrere Drittanbieter-Apps im Marketplace. Die populärsten sind HubSpot for WooCommerce (von MakeWebBetter) und verschiedene Zapier-basierte Lösungen.

Die Funktionalität ist vergleichbar mit der Shopify-Integration: Kunden, Bestellungen und Produkte werden synchronisiert. Allerdings musst du bei WooCommerce-Integrationen genauer hinsehen:

• Plugin-Kompatibilität: WooCommerce-Shops nutzen oft viele Plugins. Stelle sicher, dass die HubSpot-Integration mit deinen wichtigsten Plugins kompatibel ist – insbesondere mit Multi-Currency-Plugins, Subscription-Plugins und Custom-Checkout-Lösungen.
• Performance: Einige WooCommerce-HubSpot-Plugins können die Shop-Performance beeinträchtigen, weil sie bei jedem Seitenaufruf API-Calls senden. Teste die Performance vor und nach der Installation.
• Datenmapping: WooCommerce Custom Fields lassen sich nicht immer automatisch auf HubSpot Properties mappen. Prüfe, ob die wichtigsten Datenfelder korrekt übertragen werden.

Best Practices für stabile Integrationen

Integrationen einzurichten ist eine Sache. Sie langfristig stabil und fehlerfrei zu betreiben, ist eine ganz andere. Hier sind die Best Practices, die sich in der Praxis bewährt haben:

1. Dokumentiere jede Integration

Erstelle für jede Integration eine kurze Dokumentation: Welche Systeme sind verbunden? Welche Daten fließen in welche Richtung? Welche Trigger lösen den Sync aus? Wer ist verantwortlich? Das klingt nach Bürokratie, aber wenn sechs Monate später ein Fehler auftritt, bist du froh, dass du nicht von Null anfangen musst.

2. Implementiere Fehlerbehandlung und Monitoring

Keine Integration ist zu 100 Prozent fehlerfrei. APIs fallen aus, Tokens laufen ab, Datenformate ändern sich. Stelle sicher, dass deine Integrationen Fehler sauber abfangen und dich benachrichtigen, wenn etwas schiefläuft. Bei Zapier und Make kannst du Fehler-Benachrichtigungen per E-Mail oder Slack konfigurieren. Bei Custom-Integrationen implementiere Logging und Alerting.

3. Definiere einen Single Source of Truth

Wenn du Daten zwischen zwei Systemen synchronisierst, musst du festlegen, welches System die führende Datenquelle ist. Beispiel: Kontaktdaten werden in HubSpot gepflegt (Single Source of Truth), Bestelldaten kommen aus dem Shop. Wenn ein Kontakt in beiden Systemen unterschiedliche E-Mail-Adressen hat, welche gewinnt? Diese Frage musst du vor der Integration klären, nicht erst wenn der erste Konflikt auftritt.

4. Teste mit echten Daten – aber in einer Sandbox

HubSpot bietet Sandbox-Accounts für Professional- und Enterprise-Kunden an. Nutze diese Sandbox, um Integrationen zu testen, bevor du sie auf dein Live-Portal loslegst. Teste nicht nur den Happy Path (alles funktioniert), sondern auch Edge Cases: Was passiert, wenn ein Pflichtfeld leer ist? Wenn ein Kontakt gelöscht wird? Wenn die API-Antwort unerwartet ist?

5. Plane regelmäßige Reviews ein

Setze dir einen Reminder: Einmal pro Quartal prüfst du alle aktiven Integrationen. Funktionieren sie noch korrekt? Gibt es Fehlermeldungen? Haben sich die Anforderungen geändert? Gibt es neue, bessere Apps im Marketplace? Integrationen, die du einmal einrichtest und dann vergisst, werden irgendwann zum Problem – garantiert.

6. Halte die Datenqualität hoch

Eine Integration ist nur so gut wie die Daten, die durch sie fließen. Wenn deine Kontaktdaten in HubSpot voller Duplikate, veralteter E-Mail-Adressen und fehlender Pflichtfelder sind, wird auch die beste Integration nicht helfen. Investiere in Datenqualität: Nutze HubSpot-Formulare mit Pflichtfeldern und Validierung, implementiere Deduplizierungsregeln und bereinige deine Datenbank regelmäßig.

7. Beachte den Datenschutz

Jede Integration, die personenbezogene Daten überträgt, ist datenschutzrechtlich relevant. Prüfe, ob der Drittanbieter DSGVO-konform arbeitet, wo die Daten verarbeitet und gespeichert werden und ob du einen Auftragsverarbeitungsvertrag (AVV) abschließen musst. Bei US-basierten Anbietern wie Zapier solltest du die Datenschutzrichtlinien besonders sorgfältig prüfen.