HubSpot-API im kostenlosen CRM: Was für Integrationen wirklich drin ist

Eine Frage kommt bei mir immer wieder auf den Tisch, meistens ganz am Anfang eines Projekts: "Wir nutzen das kostenlose HubSpot. Können wir damit überhaupt eine Schnittstelle bauen, oder müssen wir erst ein bezahltes Paket kaufen?"

Kurze Antwort: Ja, die API ist im kostenlosen CRM voll nutzbar. Du kannst Kontakte, Firmen und Deals per Schnittstelle lesen und schreiben, ohne einen Cent für HubSpot zu zahlen. Es gibt ein paar echte Grenzen, aber die liegen woanders, als die meisten vermuten.

Ich erkläre hier, was im Free-Tier per API tatsächlich geht, wo Schluss ist, und ab welchem Punkt sich der Sprung zu einer eigenen Schnittstelle oder einem höheren Paket lohnt.

Wie der API-Zugang bei HubSpot heute funktioniert

Wer vor ein paar Jahren mit HubSpot integriert hat, kennt noch die alten API-Keys: ein Schlüssel pro Account, der auf alles Zugriff hatte. Die hat HubSpot abgeschaltet. Heute läuft der Zugang über zwei Wege.

Für deine eigenen, internen Anbindungen baust du eine Private App. Das machst du direkt in den Einstellungen deines HubSpot-Accounts: App anlegen, festlegen welche Bereiche sie lesen und schreiben darf (die sogenannten Scopes), und du bekommst einen Access Token. Mit diesem Token sprichst du die API an. Das funktioniert im kostenlosen CRM genauso wie in einem Enterprise-Account.

Der zweite Weg sind OAuth-Apps. Die brauchst du, wenn du eine Anwendung baust, die sich an fremden HubSpot-Accounts anmelden soll, etwa ein Produkt für den HubSpot Marketplace. Für eine normale Anbindung an dein eigenes CRM ist das überdimensioniert. Da reicht die Private App.

Wichtig zum Einordnen: Eine Private App ist kein Hexenwerk, aber sie braucht ein bisschen Sorgfalt. Der Token ist faktisch ein Generalschlüssel zu den Bereichen, die du freigegeben hast. Er gehört in einen sicheren Speicher, nicht ins Frontend und nicht in ein öffentliches Repository.

Was du im Free-CRM per API anbinden kannst

Das HubSpot-CRM ist um eine Handvoll Standard-Objekte herum gebaut, und die sind über die CRM-API alle erreichbar, auch kostenlos:

Kontakte und Firmen lesen, anlegen, aktualisieren
Deals und Tickets verwalten
Aktivitäten wie Notizen, Aufgaben, E-Mails, Anrufe und Meetings an Datensätze hängen
Verknüpfungen zwischen Objekten setzen, also etwa einen Kontakt mit einer Firma und einem Deal verbinden
Properties auslesen und befüllen, auch eigene Felder, die du im CRM angelegt hast

Damit deckst du den Großteil dessen ab, wofür Integrationen in der Praxis gebaut werden. Ein typischer Fall aus meinen Projekten: Ein Formular auf einer externen Plattform erzeugt per API einen Kontakt in HubSpot, verknüpft ihn mit der passenden Firma und legt einen Deal in der richtigen Pipeline an. Dafür brauchst du kein bezahltes Paket.

Auch das Auslesen funktioniert sauber. Du kannst über die Such-Endpunkte gezielt nach Datensätzen filtern, paginierst dich durch größere Mengen und holst dir genau die Properties, die du brauchst. Für einen nächtlichen Abgleich mit einem anderen System reicht das völlig.

Wo im kostenlosen Tier wirklich Schluss ist

Die Grenzen verlaufen nicht entlang der Frage "API ja oder nein", sondern entlang von drei anderen Linien.

Custom Objects. Wenn dein Geschäft Objekte braucht, die HubSpot nicht von Haus aus kennt – sagen wir "Fahrzeuge", "Verträge" oder "Maschinen" als eigene Objektart mit eigenen Feldern und Verknüpfungen – dann brauchst du dafür ein Enterprise-Paket. Im Free-CRM modellierst du solche Fälle über die vorhandenen Objekte und eigene Properties. Das geht oft erstaunlich weit, hat aber irgendwann eine natürliche Decke.

Echtzeit-Benachrichtigungen. Wenn deine Integration sofort reagieren soll, sobald sich in HubSpot etwas ändert, willst du Webhooks statt regelmäßigem Abfragen. Die laufen über eine App-Konfiguration und sind im Standard-CRM nicht so frei verfügbar wie das reine Lesen und Schreiben. In vielen Projekten löse ich das im Free-Tier pragmatisch über einen geplanten Abgleich alle paar Minuten. Für die meisten Anwendungsfälle ist das schnell genug.

Bestimmte Hub-spezifische APIs. Funktionen, die an Marketing Hub, Sales Hub oder Operations Hub in höheren Stufen hängen, sind über die API auch nur dann erreichbar, wenn du das jeweilige Paket hast. Die programmatische Datenpflege über Operations Hub ist so ein Beispiel. Das reine CRM bleibt davon unberührt.

Die Rate Limits: der Punkt, den man früh kennen sollte

HubSpot begrenzt, wie viele API-Aufrufe du in einem bestimmten Zeitfenster machen darfst. Das ist der Faktor, der bei größeren Datenmengen wirklich relevant wird, nicht das Paket an sich.

Für Private Apps im Free- und Starter-Bereich liegt das Limit nach der HubSpot-Dokumentation bei rund 100 Anfragen pro 10 Sekunden und etwa 250.000 Anfragen pro Tag (Stand Anfang 2026; HubSpot passt diese Werte an, im Zweifel die offizielle Limits-Seite prüfen). Höhere Pakete heben vor allem das Tageslimit deutlich an.

Was bedeutet das praktisch? Solange du einzelne Datensätze synchronisierst oder über den Tag verteilt arbeitest, merkst du von diesen Grenzen nichts. Eng wird es bei großen Erstbefüllungen oder bei häufigen Voll-Abgleichen. Wenn du 100.000 Kontakte am Stück einlesen willst, musst du den Lauf so bauen, dass er die Limits respektiert: in Stapeln arbeiten, die Batch-Endpunkte nutzen, die mehrere Datensätze pro Aufruf verarbeiten, und bei einem Limit-Treffer sauber warten statt blind weiterzufeuern.

Genau an dieser Stelle entscheidet sich oft, ob eine Integration im Alltag stabil läuft oder ständig hängt. Nicht das HubSpot-Paket ist das Problem, sondern wie die Schnittstelle mit den Limits umgeht.

Wann das kostenlose CRM reicht und wann nicht

Aus der Praxis: Für eine saubere Anbindung zwischen HubSpot und einem oder zwei anderen Systemen reicht das kostenlose CRM in den allermeisten Fällen. Kontakte rein, Deals aktualisieren, Daten zwischen Tools abgleichen, ein Formular anbinden. Das alles baue ich regelmäßig auf Free-Accounts.

Über ein höheres Paket reden wir, wenn einer dieser Punkte zutrifft: Du brauchst eigene Objektarten jenseits von Kontakt, Firma, Deal und Ticket. Deine Prozesse hängen an Funktionen eines bestimmten Hubs. Oder dein Datenvolumen sprengt die Tageslimits des Free-Tiers regelmäßig.

Und es gibt einen vierten Fall, der nichts mit dem HubSpot-Paket zu tun hat: Sobald die Logik zwischen den Systemen komplizierter wird, lohnt sich eine eigene Schnittstelle dazwischen. Eine kleine Middleware, die Daten aus mehreren Quellen zusammenführt, Felder umrechnet, Sonderfälle behandelt und die Rate Limits im Griff hat. Die HubSpot-API gibt dir die Bausteine. Wie robust das Ganze am Ende läuft, hängt davon ab, was zwischen den APIs passiert.

Solche Schnittstellen baue ich bei Pipewave: von der simplen Formular-Anbindung bis zur Middleware, die HubSpot mit ERP, Buchhaltung oder einer eigenen Anwendung verbindet. Wie das in einem konkreten Projekt aussieht, zeige ich in der Case Study zu n8n-HubSpot-Workflows.

Wenn du gerade vor der Frage stehst, ob dein HubSpot-Paket für deine geplante Anbindung reicht, schau dir an, was ich bei CRM-Integration und eigenen Schnittstellen mache, oder schreib mir direkt über das Kontaktformular. Ich sage dir ehrlich, ob das Free-CRM für deinen Fall trägt oder wo du an eine echte Grenze stößt.

Geschrieben von Joshua Kresse. Ich baue bei Pipewave HubSpot-Integrationen und eigene Schnittstellen für B2B-Unternehmen.