Technische Parameter der HubSpot-API
4 Automatisierungsmöglichkeiten mit der HubSpot-API
Konkrete Anwendungsfälle der HubSpot-API in B2B-Automatisierungsprojekten — mit Beschreibung der Logik, verwendeten Endpunkten und realer Zeitersparnis.
Automatische Deal-Erstellung nach Formularausfüllung
Ein Formular auf der Website sendet Daten über die API. Die Automatisierung prüft, ob der Kontakt im CRM existiert (GET /crm/v3/contacts/search), legt ihn ggf. an (POST /crm/v3/contacts) und erstellt einen Deal (POST /crm/v3/deals) mit Zuweisung an den richtigen Vertriebsmitarbeiter nach Branche und Region.
POST /crm/v3/contactsPOST /crm/v3/dealsGET /crm/v3/contacts/searchKI-gestützte Lead-Qualifizierung
Trigger: eine Kontakteigenschaft wurde aktualisiert. Webhook sendet Daten an Make. Make holt das vollständige Kontaktprofil via HubSpot-API und sendet es an die Claude-API mit einem Qualifizierungsprompt. KI bewertet den Lead — Make aktualisiert HubSpot-Eigenschaften und verschiebt den Deal auf die passende Pipeline-Stufe.
GET /crm/v3/contacts/{id}PATCH /crm/v3/contacts/{id}PATCH /crm/v3/deals/{id}HubSpot-Synchronisierung mit Lexoffice oder sevDesk
Nach Deal-Abschluss (Stage "closedwon") triggert ein Webhook Make. Make liest Deal-Daten, erstellt eine Rechnung in Lexoffice und aktualisiert den Deal in HubSpot mit Rechnungs-ID und PDF-Link als benutzerdefinierte Eigenschaften.
GET /crm/v3/deals/{id}PATCH /crm/v3/deals/{id}Pipeline-Reporting und Umsatzprognose
Täglich werden alle aktiven Deals aus HubSpot abgerufen, nach Pipeline-Stufe und Eigentümer aggregiert und in Google Sheets oder BigQuery exportiert. Die Geschäftsführung sieht um 8:00 Uhr eine aktualisierte Umsatzprognose — ohne manuelles Reporting.
POST /crm/v3/deals/searchGET /crm/v3/pipelines/dealsWichtige HubSpot-API-Endpunkte
Die am häufigsten genutzten Endpunkte in Automatisierungsprojekten. Alle Endpunkte unterstützen Authentifizierung über OAuth 2.0 oder Private App Token.
/crm/v3/contacts/search
Kontakt nach E-Mail, Name, Eigenschaft suchen
/crm/v3/contacts
Neuen Kontakt anlegen
/crm/v3/contacts/{id}
Kontakteigenschaften aktualisieren
/crm/v3/deals
Deal in einer Pipeline erstellen
/crm/v3/deals/search
Deals mit Filtern suchen
/crm/v3/deals/{id}
Deal auf Stufe verschieben, Eigenschaften aktualisieren
Testen Sie Endpunkte in einer Sandbox-Umgebung (falls verfügbar) oder mit einem dedizierten Test-Account, bevor Sie die Integration produktiv schalten. Die technische Dokumentation der HubSpot-API finden Sie unter https://developers.hubspot.com/docs/api/overview.
Beispielflow: Flow: Formular → HubSpot Kontakt + Deal → KI-Qualifizierung → Slack
- Lead füllt Formular auf der Website aus (HubSpot Forms)
- HubSpot erstellt Kontakt und triggert form_submission-Ereignis
- Webhook (HubSpot → Make): form_submission mit Kontakt-ID
- Make holt vollständiges Profil: GET /crm/v3/contacts/{id}?properties=company,jobtitle,country
- Make sendet Daten an Claude API — KI bewertet Lead-Potenzial (1–10)
- Score ≥ 7: Make erstellt Deal (POST /crm/v3/deals) und setzt Stage auf "Qualifiziert"
- Make sendet Slack-Alert mit KI-Zusammenfassung und HubSpot-Link
- Score < 7: Make fügt Kontakt zur Nurturing-Sequenz hinzu
Wie JustAutomate HubSpot-Integrationen umsetzt
In JustAutomate-Projekten ist die Integration der HubSpot-API eines der häufigsten Automatisierungselemente. Unser Prozess beginnt mit einem API-Audit: Wir prüfen verfügbare Endpunkte, Rate-Limits, Token-Stabilität und Datenformate auf Kundenseite.
In den meisten Fällen nutzen wir Make oder n8n als Middleware — Tools, die die HubSpot-API ohne Programmieraufwand mit anderen Systemen verbinden. Für komplexe Fälle (eigene Transformationslogik, Legacy-System-Anbindung, ungewöhnliche Datenformate) entwickeln wir eigene Node.js- oder Python-Skripte mit vollständiger Fehlerbehandlung und Logging.
Jede Integration, die wir aufbauen, wird überwacht: Wir wissen sofort, wenn die API einen 5xx-Fehler zurückgibt oder ein Rate-Limit erreicht wird — bevor der Fehler Ihre Geschäftsprozesse beeinträchtigt.
Wenn Sie HubSpot in Ihre bestehenden Systeme integrieren möchten, besprechen wir Umfang und ROI in einem 30-minütigen Gespräch — unverbindlich und kostenfrei.
FAQ — Häufige Fragen zur HubSpot-API
Welchen Token für HubSpot API wählen — OAuth oder Private App?
Für interne Automatisierungen (n8n, Make, eigene Skripte) empfiehlt sich ein Private App Token — einfacher zu konfigurieren, läuft nicht nach einer Stunde ab. OAuth 2.0 eignet sich für Anwendungen, die an externe Nutzer oder den HubSpot-Marketplace weitergegeben werden.
Wie verarbeitet die HubSpot-API benutzerdefinierte Eigenschaften?
Benutzerdefinierte Eigenschaften legen Sie einmalig in HubSpot an (CRM → Eigenschaften) oder per API (POST /crm/v3/properties/contacts). Danach verwenden Sie den internen Namen (z.B. "rechnung_id") in GET/PATCH genauso wie Standardeigenschaften.
Wie viele API-Anfragen sind pro Minute erlaubt?
HubSpot begrenzt auf 100–150 Anfragen pro 10 Sekunden für Private Apps. Für Massenoperationen nutzen Sie die Batch-API — z.B. POST /crm/v3/contacts/batch/update — die bis zu 100 Datensätze in einer Anfrage verarbeitet.
Wie richtet man Webhooks in HubSpot ein?
Webhooks konfigurieren Sie unter Apps → Webhooks im Entwickler-Panel. Sie wählen Ereignistypen (contact.creation, deal.propertyChange usw.), geben eine URL und ein Signing-Secret an. HubSpot sendet ein POST mit einem JSON-Array der Ereignisse.
Brauchen Sie eine HubSpot-Integration
für Ihre Prozesse?
Wir bauen HubSpot-API-Integrationen mit CRM, ERP, Buchhaltung und KI-Tools. Kostenloses Erstgespräch — 30 Minuten, konkreter Plan mit ROI-Einschätzung.