Verbindung von HubSpot mit Google Sheets - Abfrage von CRM-Daten mit SQL

HubSpot mit Google Sheets verbinden

Daten abrufen von HubSpot hinein Google Sheets

Importieren Sie Live-Datensätze aus Ihrem HubSpot-Konto in Google Tabellen und aktualisieren Sie diese nach Belieben. Kein CSV-Upload, kein Apps Script, kein Kopieren und Einfügen. Die erste Einrichtung dauert etwa zehn Minuten und ist im kostenlosen Plan enthalten.

Ungefähr 10 Minuten Keine Programmierung erforderlich Die Zugangsdaten bleiben bei Ihnen Jeder Browser, jedes Gerät

Was am Ende dabei herauskommt

Ein Google Sheet, das die Live-Ergebnisse einer SQL-Abfrage für Ihr HubSpot-Konto anzeigt, mit einer Schaltfläche, die bei jeder Datenänderung die neuesten Zeilen abruft. Zum Beispiel so:

Vertrieb Auf Laufwerk gespeichert

DateiBearbeitenSichtEinfügenFormatDatenWerkzeugeErweiterungenHelfen

	A	B	C	D	E
1	kunden_id	Vorname	Nachname	Land	insgesamt
2	1042	Maria	Alvarez	USA	1,284.50
3	1043	Daniel	Okafor	USA	612.00
4	1047	Priya	Nair	USA	2,090.75
5	1051	Thomas	Berg	USA	338.20
6	1056	Lucía	Ferreira	USA	1,455.00
7	1060	Kenji	Sato	USA	874.10
8

+ Kunden Blatt1 Live von HubSpot

HubSpot speichert Ihre Daten hinter seiner API. Um sie in Google Sheets zu importieren, müssen Sie normalerweise jedes Mal eine CSV-Datei aus dem HubSpot-Dashboard exportieren, wenn Sie aktuelle Zahlen benötigen. Query Streams umgeht diesen Schritt: Ein kleines Hilfsprogramm, der sogenannte Agent, führt die Abfrage direkt am Speicherort Ihrer Daten aus, und ein Google Sheets-Add-on fragt die gewünschten Zeilen ab. Nur die Ergebnisse werden über eine verschlüsselte Verbindung übertragen, und Google Sheets ist überall verfügbar: in jedem Browser auf jedem Gerät.

Was Sie benötigen

Ein Query Streams-Konto

Für diesen Leitfaden reicht der kostenlose Tarif aus. Melden Sie sich an unter mein.querystreams.de.

Der Agent auf jedem ständig eingeschalteten Computer

Ein kleines Programm, das im Hintergrund läuft und HubSpot aufruft, wenn Google Sheets eine Anfrage stellt. Es benötigt lediglich einen Internetzugang.

Ihr HubSpot-Login

Sie melden sich einmalig bei HubSpot an und gewähren Lesezugriff. In Query Streams werden keine Passwörter eingegeben.

Verbinden Sie es in fünf Schritten

1. Erstellen Sie Ihr Konto

   Gehen Sie zu mein.querystreams.de und melde dich an. Wähle die Kostenlos Es handelt sich um einen echten Plan, nicht um eine Testversion, und er beinhaltet die Verbindung Ihres HubSpot-Kontos und die Ausführung von Abfragen aus Google Sheets.

2. Installieren Sie den Agenten auf einem beliebigen, ständig eingeschalteten Computer.

   Anmelden, öffnen HerunterladenInstallieren Sie den Agenten auf einem beliebigen Computer oder Server mit ständigem Internetzugang. Das dauert nur eine Minute und der Agent startet anschließend automatisch.

   Warum ein kleines Programm anstelle eines Treibers? Der Agent ist eine einmalige Installation für Windows, Mac oder Linux (ca. 85 MB unter Windows, etwas über 100 MB unter Mac und Linux) und läuft unauffällig im Hintergrund. Er stellt eine einzige, verschlüsselte Verbindung zu Query Streams her, genau wie ein Browser. Daher müssen Sie weder einen Firewall-Port öffnen noch ein VPN einrichten. Ihre Schlüssel verbleiben auf Ihrem Rechner, und die Datensätze werden – falls nötig über das Internet – an Ihren Standort übertragen. Sie benötigen lediglich das Add-on.

   Die Downloadseite zeigt Ihr ZugangsschlüsselFügen Sie es in das Feld des Agenten ein, wenn Sie dazu aufgefordert werden, und warten Sie, bis das Abzeichen gelesen wurde. Verbunden mit AbfrageströmenDas ist das Einzige, was Sie auf dem Agenten selbst tun.

   Vollständige Komplettlösungen, falls gewünscht: Fenster, Mac, Linux.

3. Richten Sie es auf Ihr HubSpot-Konto aus.

   Zurück im Browser, öffnen Datenagenten (unter Daten (im oberen Menü). Ihr Agent ist dort aufgeführt. Anschluss hinzufügen und wählen HubSpotBenötigen Sie zuerst Ihre HubSpot-Zugangsdaten? Öffnen Sie die Anleitung und füllen Sie die Felder aus:

   Erstellen Sie Ihre HubSpot-Zugangsdaten. (ca. 5 Minuten)

   Öffnen Sie anschließend HubSpot in einem weiteren Tab. Query Streams speichert die hier erstellten Daten, sodass Ihr Agent sie verwenden kann, und liest ausschließlich Daten aus HubSpot.

   Wer kann das tun?

   Ein Superadministrator oder ein Benutzer mit Zugriffsberechtigung für die Entwicklertools (Dienstschlüssel) ist erforderlich. Ältere private Anwendungen benötigen einen Superadministrator.

   Empfohlen

   Service-Schlüssel mit schreibgeschützten Berechtigungen (Entwicklung → Schlüssel → Service-Schlüssel). HubSpot empfiehlt Service-Schlüssel für geplante Datensynchronisierungen mit BI-Tools und Data Warehouses und entfernt die Option zum Erstellen neuer älterer privater Apps.

   Bevor Sie beginnen

   • Ein HubSpot-Login mit Super-Admin-Rechten oder Zugriff auf die Entwicklertools. Einem Service-Schlüssel können nur Berechtigungen zugewiesen werden, die Ihr eigener HubSpot-Benutzer bereits besitzt.
   • Wissen Sie, welches HubSpot-Konto Sie abfragen möchten. Ein Schlüssel liest nur das Konto, in dem er erstellt wurde. Erstellen Sie ihn daher in diesem Konto und nicht in einem Test- oder Sandbox-Konto.
   • Entscheiden Sie, welche HubSpot-Tabellen Sie benötigen. Kontakte, Unternehmen, Deals, Inhaber, Pipelines, Pipeline-Phasen und Eigenschaften sind standardmäßig aktiviert; jede weitere Tabelle benötigt einen eigenen Lesebereich (siehe Berechtigungen).
   • Der Query Streams Agent ist auf einem ständig eingeschalteten Computer installiert und online, und das Query Streams Portal ist in einem anderen Tab geöffnet: Data Agents → Konnektor hinzufügen → HubSpot.

   Schritte

   1. Melden Sie sich bei HubSpot an

      Öffnen Sie HubSpot in einem neuen Tab und melden Sie sich als Super-Admin oder als Benutzer mit der Zugriffsberechtigung für Entwicklertools an.

      Wenn Sie mehreren HubSpot-Konten angehören, wechseln Sie bitte zu dem Konto, dessen Daten Sie benötigen, bevor Sie fortfahren. Der Schlüssel funktioniert nur für das Konto, in dem er erstellt wurde.

   2. Offene Entwicklung

      Klicken Sie in der linken Hauptnavigation unten auf „Entwicklung“ (das Symbol </>). Die Entwicklungsseite öffnet sich mit einer eigenen Seitenleiste: Übersicht, Projekte, Legacy-Anwendungen, Überwachung, Schlüssel und mehr.

      Kein Entwicklereintrag? Ihr HubSpot-Benutzer ist kein Super-Admin und hat keinen Zugriff auf die Entwicklertools. Bitten Sie einen Super-Admin, den Schlüssel zu erstellen oder Ihnen die entsprechende Berechtigung zu erteilen.

   3. Service-Schlüssel öffnen

      Klicken Sie in der Entwicklungs-Seitenleiste auf „Schlüssel“, um sie zu erweitern, und anschließend auf „Dienstschlüssel“ (mit Beta-Symbol). Die Seite „Dienstschlüssel“ wird geöffnet; falls Sie noch keine haben, wird „Keine Dienstschlüssel erstellt“ angezeigt.

      Verwenden Sie nicht den persönlichen Zugriffsschlüssel oder den Entwickler-API-Schlüssel, die sich direkt über den Dienstschlüsseln im selben Menü befinden. Es handelt sich dabei um Schlüssel für Entwicklertools, die keine Verbindung herstellen können. Einige Konten erreichen diese Seite auch über Einstellungen (Zahnradsymbol) → Integrationen → Dienstschlüssel.

   4. Klicken Sie auf „Dienstschlüssel erstellen“.

      Klicken Sie oben rechts auf der Seite „Dienstschlüssel“ auf „Dienstschlüssel erstellen“. Die Seite „Dienstschlüssel erstellen“ öffnet sich mit einem Namensfeld und einem Abschnitt „Bereiche“.

   5. Benennen Sie den Schlüssel

      Geben Sie im Feld „Name“ einen Namen ein, den Sie später wiedererkennen, z. B. „Abfrage-Streams (schreibgeschützt)“. HubSpot zeigt diesen Namen in seinen Protokollen an.

      Der Name muss in Ihrem HubSpot-Konto eindeutig sein.

   6. Öffne die Zielfernrohrauswahl

      Klicken Sie neben „Ausgewählte Bereiche“ auf „+ Neuen Bereich hinzufügen“. Rechts öffnet sich ein Fenster mit einem Suchfeld für einen Bereich und einem Kontrollkästchen für jeden Bereich.

   7. Markieren Sie die vier erforderlichen Bereiche.

      Geben Sie jeden Namen in „Bereich suchen“ ein und aktivieren Sie das entsprechende Kontrollkästchen: crm.objects.contacts.read, crm.objects.companies.read, crm.objects.deals.read, crm.objects.owners.read. Diese vier Tabellen decken alle Tabellen ab, die Query Streams standardmäßig synchronisiert.

      Aktivieren Sie nur Bereiche, die auf .read enden. Query Streams liest ausschließlich Daten aus HubSpot; ein .write-Bereich ist dafür nicht erforderlich.

   8. Aktivieren Sie die Kontrollkästchen für alle zusätzlichen Tabellen.

      Markieren Sie für jede zusätzliche Tabelle, die Sie benötigen, deren Gültigkeitsbereich in der unten stehenden Berechtigungsliste. Beispiele: crm.objects.tickets.read für Tickets; crm.objects.line_items.read für Positionen, Steuern, Rabatte und Gebühren; crm.lists.read für Listen. Überspringen Sie diesen Schritt, falls die Standardtabellen ausreichen.

      Sie können Bereiche später hinzufügen, ohne einen neuen Schlüssel zu erstellen (öffnen Sie den Schlüssel und klicken Sie dann auf Bearbeiten).

   9. Klicken Sie auf „Aktualisieren“.

      Klicken Sie im rechten Bereich auf „Aktualisieren“. Der Bereich schließt sich und Ihre Scopes werden unter „Ausgewählte Scopes“ aufgelistet.

   10. Überprüfen Sie die Liste der Geltungsbereiche.

       Lesen Sie die ausgewählten Bereiche durch. Wenn ein Eintrag auf „.write“ endet, klicken Sie daneben auf „Löschen“. Erweitern Sie die Zusammenfassung der ausgewählten Bereiche, um eine Liste in Klartext anzuzeigen, auf die der Schlüssel zugreifen kann.

   11. Schlüssel erstellen

       Klicken Sie oben rechts auf „Erstellen“ und bestätigen Sie anschließend im sich öffnenden Dialogfeld.

   12. Öffnen Sie Ihren neuen Schlüssel

       Gehen Sie zu Entwicklung → Schlüssel → Dienstschlüssel und klicken Sie auf den Namen des soeben erstellten Schlüssels. Die Detailseite öffnet sich mit einem Feld für den Dienstschlüssel.

   13. Zeigen und kopieren Sie den Schlüssel

       Im Feld „Dienstschlüssel“ ist der Wert teilweise ausgeblendet und beginnt mit „pat-“ (z. B. „pat-na1-…“). Klicken Sie darunter auf „Anzeigen“ und anschließend auf „Kopieren“.

       Verwenden Sie die Kopierfunktion, anstatt den Text manuell auszuwählen: Fehlende Zeichen, nachfolgende Leerzeichen oder versteckte Punkte führen zu einem Fehler. HubSpot zeigt den Schlüssel nicht nur einmal an; Sie können jederzeit zurückkehren und erneut auf „Anzeigen“ klicken. Behandeln Sie ihn wie ein Passwort.

   14. Fügen Sie es in Query Streams ein und testen Sie es.

       Öffnen Sie im Query Streams-Portal die Datenagenten, klicken Sie auf „Connector hinzufügen“ und wählen Sie HubSpot aus. Fügen Sie den Schlüssel in das Feld „App-Zugriffstoken“ ein, geben Sie einen Verbindungsnamen ein und klicken Sie anschließend auf „Verbindung testen“. Das Ergebnis lautet „Verbunden“.

       Query Streams speichert den Schlüssel für Ihren Agenten und liest ausschließlich Ihre HubSpot-Daten.

   15. Ordnen Sie die Tabellen Ihren Zielfernrohren zu.

       Im anschließenden Synchronisierungsschritt lassen Sie nur die HubSpot-Tabellen ausgewählt, deren Bereiche Sie in den Schritten 7 und 8 markiert haben, und beenden Sie dann den Assistenten.

       Eine Tabelle, die ohne ihren Gültigkeitsbereich aktiviert wurde, kann nicht synchronisiert werden und gibt einen „Verboten“-Fehler aus. Fügen Sie den Gültigkeitsbereich dem Schlüssel hinzu (Schritt 8) oder deaktivieren Sie die Tabelle.

   Alternativen

   Verwenden Sie ein älteres privates App-Token.

   Ihr Konto verfügt bereits über eine ältere private App, die Sie wiederverwenden möchten. HubSpot entfernt die Option, neue Apps zu erstellen: Konten, die am oder nach dem 28. September 2026 erstellt wurden, können dies bereits nicht mehr, und ältere Konten verlieren diese Option am 26. Oktober 2026. Bestehende private Apps und ihre Token funktionieren weiterhin.

   Wer kann das tun? Super-Admin

   1. Open Legacy Apps

      Klicken Sie in HubSpot in der linken Hauptnavigation auf „Entwicklung“ und anschließend in der Seitenleiste „Entwicklung“ auf „Legacy Apps“.

      In der älteren HubSpot-Navigation hieß dieser Menüpunkt Einstellungen → Integrationen → Private Apps.

   2. Öffne deine private App oder starte eine neue.

      Wenn die App aufgeführt ist, klicken Sie auf ihren Namen und fahren Sie mit Schritt 6 fort (oder mit Schritt 5, um Bereiche hinzuzufügen). Falls nicht und die Schaltfläche noch vorhanden ist, klicken Sie oben rechts auf „Legacy-App erstellen“ und wählen Sie im Dialogfeld „Privat“ aus.

      Wenn die Schaltfläche „Legacy-App erstellen“ fehlt, ist die Erstellung für Ihr Konto bereits deaktiviert. Verwenden Sie stattdessen einen Dienstschlüssel (siehe Hauptschritte).

   3. Benennen Sie die neue App

      Geben Sie auf der Registerkarte „Basisinformationen“ einen Namen wie „Abfragestreams (schreibgeschützt)“ ein. Logo und Beschreibung sind optional.

   4. Füge die Lesebereiche hinzu.

      Klicken Sie auf den Tab „Bereiche“, dann auf „Neuen Bereich hinzufügen“, wählen Sie dieselben Bereiche wie in den Hauptschritten 7 und 8 aus und klicken Sie anschließend auf „Aktualisieren“. Klicken Sie dann oben rechts auf „App erstellen“, lesen Sie die Zugriffstoken-Meldung im Dialogfeld und klicken Sie auf „Erstellung fortsetzen“.

   5. Fügen Sie einer bestehenden App Bereiche hinzu (nur falls erforderlich)

      Klicken Sie auf der App-Seite oben rechts auf „App bearbeiten“, öffnen Sie den Tab „Bereiche“, fügen Sie die fehlenden Lesebereiche hinzu und speichern Sie die Einstellungen. Die Token-Zeichenfolge ändert sich beim Ändern der Bereiche nicht.

   6. Token anzeigen und kopieren

      Klicken Sie auf der App-Seite auf den Tab „Authentifizierung“. Klicken Sie unter „Zugriffstoken“ auf „Token anzeigen“ und anschließend auf „Kopieren“. Das Token beginnt mit „pat-“. Fügen Sie es wie in Schritt 14 des Hauptprogramms in das Feld „App-Zugriffstoken“ ein.

      Wird der HubSpot-Benutzer, der die App erstellt hat, aus HubSpot entfernt, schlagen einige Aufrufe mit der Fehlermeldung „USER_DOES_NOT_HAVE_PERMISSIONS“ fehl. Drehen Sie das Token (klicken Sie dazu auf „Drehen“) und fügen Sie das neue ein oder verwenden Sie einen Dienstschlüssel.

   Verwenden Sie das statische Authentifizierungstoken einer Entwicklerplattform-App.

   Ihr Team hat bereits eine HubSpot-App auf der neuen Entwicklerplattform mit der HubSpot-CLI erstellt und diese mit statischer Authentifizierung und privater Verteilung konfiguriert. Zum Erstellen einer solchen App benötigen Sie die CLI; falls Sie keine besitzen, verwenden Sie einen Service-Schlüssel.

   Wer kann das tun? Superadministrator oder ein Benutzer mit Entwicklerlizenz benötigt das Token; Superadministrator oder der HubSpot Marketplace benötigt die Berechtigung zum Installieren der App.

   1. Öffnen Sie das Projekt

      Klicken Sie in HubSpot auf „Entwicklung“, dann in der Seitenleiste auf „Projekte“ und anschließend auf den Namen des Projekts, das Ihre App enthält.

   2. Öffne die App

      Klicken Sie auf der Registerkarte „Übersicht“ des Projekts unter „Projektkomponenten“ auf den Namen der App.

   3. Öffnen Sie die Registerkarte „Verteilung“.

      Klicken Sie auf die Registerkarte „Verteilung“.

   4. Installieren Sie die App, falls sie noch nicht installiert ist.

      Unter „Verteilung verwalten“ wird Ihr aktuelles HubSpot-Konto angezeigt. Klicken Sie auf „Jetzt installieren“, prüfen Sie, ob die angeforderten Zugriffsrechte mit den von Ihnen konfigurierten Lesebereichen übereinstimmen, und klicken Sie anschließend auf „App verbinden“.

      Eine App mit statischem Token kann jeweils nur in einem Standard-HubSpot-Konto installiert werden.

   5. Token anzeigen und kopieren

      Nach der Installation wird im Tab „Verteilung“ ein Zugriffstoken angezeigt. Klicken Sie auf „Anzeigen“, um es anzuzeigen, kopieren Sie es und fügen Sie es wie in Schritt 14 des Hauptprogramms in das Feld „App-Zugriffstoken“ ein.

      Wenn Sie die Anwendungsbereiche der App später ändern, müssen Sie sie mit der Neuinstallations-URL auf der Registerkarte „Verteilung“ neu installieren, da die neuen Anwendungsbereiche sonst nicht angewendet werden.

   Berechtigungen zur Erteilung

   Ressource	Zugang	Wird verwendet für
   crm.objekte.kontakte.lesen	Lesen	Erforderlich. hubspot.contacts sowie die Aktivitätstabellen hubspot.calls, hubspot.emails, hubspot.meetings, hubspot.notes, hubspot.tasks und hubspot.communications (die Aktivitäts-APIs von HubSpot verwenden diesen Bereich) und Kontaktfelder in hubspot.properties und hubspot.associations.
   crm.Objekte.Unternehmen.Lesen	Lesen	Erforderlich. hubspot.companys und die Firmenfelder in hubspot.properties und hubspot.associations.
   crm.objekte.geschäfte.lesen	Lesen	Erforderlich. hubspot.deals, die Deal-Pipelines in hubspot.pipelines und hubspot.pipeline_stages sowie Deal-Felder in hubspot.properties und hubspot.associations.
   crm.objekte.eigentümer.lesen	Lesen	Erforderlich. hubspot.owners, die HubSpot-Benutzer, denen Datensätze gehören, damit Deals und Kontakte mit dem Namen eines Vertriebsmitarbeiters verknüpft werden können.
   crm.objects.tickets.read	Lesen	Nur wenn Sie Tickets synchronisieren: hubspot.tickets und die Ticket-Pipelines in hubspot.pipelines und hubspot.pipeline_stages. Ältere Apps zeigen möglicherweise stattdessen den Legacy-Ticket-Bereich an, der ebenfalls Änderungen zulässt.
   crm.objects.products.read	Lesen	Nur wenn Sie Produkte synchronisieren: hubspot.products. Suchen Sie im Produkt-Picker nach Produkten; die HubSpot-Produkt-API akzeptiert diesen Bereich, obwohl er noch nicht auf der HubSpot-Referenzseite aufgeführt ist.
   crm.objects.line_items.read	Lesen	Nur wenn Sie Positionen, Steuern, Rabatte oder Gebühren synchronisieren: hubspot.line_items, hubspot.taxes, hubspot.discounts, hubspot.fees.
   crm.objects.quotes.read	Lesen	Nur wenn Sie Quotes synchronisieren: hubspot.quotes.
   crm.objects.invoices.read	Lesen	Nur wenn Sie Rechnungen synchronisieren: hubspot.invoices.
   crm.objects.subscriptions.read	Lesen	Nur wenn Sie Abonnements synchronisieren: hubspot.subscriptions (HubSpot Commerce-Abonnements).
   crm.objects.commercepayments.read	Lesen	Nur wenn Sie Zahlungen synchronisieren: hubspot.payments (HubSpot Commerce Payments).
   crm.objects.marketing_events.read	Lesen	Nur wenn Sie Marketing-Events synchronisieren: hubspot.marketing_events.
   Formen	Lesen und Schreiben (HubSpot verfügt über keinen schreibgeschützten Formularbereich)	Nur wenn Sie Formulare oder Formularübermittlungen synchronisieren: hubspot.forms und hubspot.form_submissions. Query Streams liest nur diese.
   crm.objects.feedback_submissions.read	Lesen	Nur wenn Sie Feedback synchronisieren: hubspot.feedback_submissions. Nur für Service Hub Professional oder Enterprise. Die Scope-Referenz von HubSpot lautet crm.objects.feedback_submission.read. Suchen Sie daher im Auswahlfeld nach Feedback.
   crm.lists.read	Lesen	Nur wenn Sie Listen synchronisieren: hubspot.lists.
   Automatisierung	Lesen und Schreiben (HubSpot kennt keinen Workflow-Bereich mit reinem Lesezugriff)	Nur wenn Sie Workflows synchronisieren: hubspot.workflows. Nur für Professional- oder Enterprise-Konten. Query Streams liest nur Workflow-Definitionen.
   crm.schemas.custom.read	Lesen	Nur wenn Sie benutzerdefinierte Schemas synchronisieren: hubspot.schemas (benutzerdefinierte Objektdefinitionen). Nur für Enterprise-Konten.

   In Abfrageströme einfügen

   App-Zugriffstoken

   Der in Schritt 13 kopierte Dienstschlüssel (er beginnt mit „pat-“), ein älteres privates App-Token oder ein statisches Authentifizierungstoken einer Entwicklerplattform-App.

   Häufige Probleme

   Die Testverbindung schlägt fehl mit der Meldung „Ungültiges oder abgelaufenes Zugriffstoken“, direkt nachdem Sie einen neuen Schlüssel eingefügt haben.

   Warum: Der Wert ist kein App- oder Serviceschlüssel. Häufig wird er mit dem persönlichen Zugriffsschlüssel oder dem Entwickler-API-Schlüssel verwechselt. Diese befinden sich unter „Entwicklung → Schlüssel“ neben den Serviceschlüsseln und sind für die Entwicklertools von HubSpot bestimmt.

   Fix: Gehen Sie zu Entwicklung → Schlüssel → Dienstschlüssel, öffnen Sie Ihren Schlüssel, klicken Sie auf Anzeigen, dann auf Kopieren und fügen Sie ihn in das Feld App-Zugriffstoken ein. Testen Sie die Verbindung erneut; es sollte „Verbunden“ angezeigt werden.

   Der Assistent meldet „Kein gültiges HubSpot-App-Token“, noch bevor er überhaupt einen Test durchführt.

   Warum: Nur ein Teil des Schlüssels wurde eingefügt: Der Text beginnt nicht mit pat- und ist sehr kurz oder enthält ein Leerzeichen.

   Fix: Zurück in HubSpot klicken Sie auf „Anzeigen“, verwenden dann den Link „Kopieren“ (markieren Sie den Text nicht manuell) und fügen ihn erneut ein.

   Im linken Navigationsbereich von HubSpot ist der Bereich „Entwicklung“ nicht sichtbar, oder unter „Schlüssel“ fehlt der Eintrag „Serviceschlüssel“.

   Warum: Ihr HubSpot-Benutzer ist kein Super-Admin und hat keine Zugriffsberechtigung für die Entwicklertools.

   Fix: Bitten Sie einen Super-Admin in Ihrem Unternehmen, den Schlüssel zu erstellen (Schritte 2 bis 13) und ihn in den Assistenten einzufügen, oder Ihnen Zugriff auf die Entwicklertools zu gewähren.

   Die Testverbindung zeigt „Verbunden“ an, aber eine Tabelle kann nicht synchronisiert werden, entweder mit der Fehlermeldung „Verboten“ oder weil sie leer bleibt.

   Warum: Der Schlüssel liegt darin, dass der Lesebereich für diese Tabelle fehlt, oder dass Ihr HubSpot-Plan diese Funktion nicht beinhaltet (Workflows erfordert Professional oder Enterprise; Custom Schemas erfordert Enterprise; Feedback erfordert Service Hub Professional oder Enterprise).

   Fix: Öffnen Sie den Schlüssel (Entwicklung → Schlüssel → Dienstschlüssel → Schlüsselname), klicken Sie auf „Bearbeiten“, fügen Sie den Bereich aus der Berechtigungsliste hinzu und speichern Sie die Einstellungen. Synchronisieren Sie anschließend erneut. Falls Ihr Tarif diese Funktion nicht enthält, deaktivieren Sie die entsprechende Tabelle in den Synchronisierungseinstellungen der Verbindung.

   Synchronisierungen, die zuvor funktionierten, schlagen nun mit der Fehlermeldung „Ungültiges oder abgelaufenes Zugriffstoken“ fehl.

   Warum: Jemand hat den Schlüssel geändert oder gelöscht. „Jetzt ändern und ablaufen lassen“ deaktiviert den alten Schlüssel sofort; „Später ändern und ablaufen lassen“ deaktiviert ihn nach 7 Tagen.

   Fix: Kopieren Sie den aktuellen Schlüssel unter Entwicklung → Schlüssel → Dienstschlüssel → Schlüsselname → Anzeigen → Kopieren. Bearbeiten Sie in Data Agents die HubSpot-Verbindung, fügen Sie den Schlüssel in das Feld „App-Zugriffstoken“ ein und führen Sie einen Verbindungstest durch.

   Bei Verwendung eines älteren privaten App-Tokens schlagen einige Tabellen mit der Fehlermeldung USER_DOES_NOT_HAVE_PERMISSIONS fehl.

   Warum: Der HubSpot-Nutzer, der die private App erstellt hat, wurde aus dem Konto entfernt.

   Fix: Drehen Sie das Token der App (Entwicklung → Legacy-Apps → App → Drehen) und fügen Sie das neue Token in die Verbindung ein, oder erstellen Sie stattdessen einen Dienstschlüssel.

   Die Option „Legacy-App erstellen“ ist nicht verfügbar, und in der HubSpot-Dokumentation werden private Apps als Legacy-Apps bezeichnet.

   Warum: HubSpot stellt die Erstellung neuer Legacy-Private-Apps ein (bereits deaktiviert für Konten, die ab dem 28. September 2026 erstellt wurden; deaktiviert für ältere Konten ab dem 26. Oktober 2026). Bestehende Private-Apps funktionieren weiterhin.

   Fix: Erstellen Sie einen Serviceschlüssel (Hauptschritte). Vorhandene private App-Token können beibehalten werden.

   Die Daten in Query Streams stimmen nicht mit dem überein, was Sie in HubSpot sehen.

   Warum: Der Schlüssel wurde in einem anderen HubSpot-Konto erstellt (z. B. in einem Test- oder Sandbox-Konto).

   Fix: Wechseln Sie zum richtigen HubSpot-Konto, erstellen Sie dort einen Schlüssel und fügen Sie ihn in die Verbindung ein.

   Grenzen, die man kennen sollte

   • HubSpots Limits für Service-Schlüssel und private Apps: 100 Anfragen pro 10 Sekunden und Schlüssel in den Versionen Free und Starter, 190 in den Versionen Professional und Enterprise, 250 mit dem Add-on „API-Limit-Erhöhung“. Der Agent passt seine Geschwindigkeit an den niedrigsten dieser Werte an, daher kann die erste vollständige Synchronisierung eines großen CRM-Systems einige Zeit dauern.
   • Tägliches Limit pro HubSpot-Konto: 250.000 Anfragen in der kostenlosen und der Starter-Version, 625.000 in der Professional-Version und 1.000.000 in der Enterprise-Version. Dieses Limit wird von allen privaten App- und Serviceschlüsseln im Konto geteilt, sodass auch andere Integrationen dasselbe Budget nutzen.
   • Die CRM-Suche von HubSpot, die der Agent verwendet, um nur geänderte Datensätze abzurufen, erlaubt 5 Anfragen pro Sekunde pro Konto und maximal 10.000 Ergebnisse pro Abfrage.
   • Einige Tabellen sind von Ihrem HubSpot-Plan abhängig: Workflows (Professional oder Enterprise), Benutzerdefinierte Schemas (Enterprise), Feedback (Service Hub Professional oder Enterprise).
   • Die Service-Keys befinden sich seit dem 10. Februar 2026 in der öffentlichen Beta-Phase, daher kann HubSpot die Details ändern. HubSpot empfiehlt, die Keys alle sechs Monate zu erneuern.
   • Neue Legacy-Private-Apps können nicht in Konten erstellt werden, die am oder nach dem 28. September 2026 erstellt wurden, noch in älteren Konten ab dem 26. Oktober 2026. Bestehende Apps und Token funktionieren weiterhin.

   Schritte geprüft am 8. Oktober 2026. Quellen: developers.hubspot.com/docs/apps/developer-platform/build…, developers.hubspot.com/changelog/service-keys, developers.hubspot.com/blog/hubspot-service-keys-the-righ…, developers.hubspot.com/changelog/legacy-private-app-creat…, developers.hubspot.com/docs/apps/legacy-apps/private-apps…, developers.hubspot.com/docs/apps/developer-platform/build…, developers.hubspot.com/docs/apps/developer-platform/build…, developers.hubspot.com/docs/apps/developer-platform/build…, developers.hubspot.com/docs/getting-started/developer-ove…, developers.hubspot.com/docs/apps/developer-platform/build…, developers.hubspot.com/docs/developer-tooling/platform/us…, developers.hubspot.com/docs/api-reference/latest/crm/sear…, knowledge.hubspot.com/user-management/hubspot-user-permis…, developers.hubspot.com/docs/api-reference/legacy/crm/obje…, developers.hubspot.com/docs/api-reference/legacy/crm/acti…, developers.hubspot.com/docs/api-reference/legacy/crm/acti…, developers.hubspot.com/docs/api-reference/legacy/crm/obje…, developers.hubspot.com/docs/api-reference/legacy/crm/obje…, developers.hubspot.com/docs/api-reference/legacy/crm/pipe…, developers.hubspot.com/docs/api-reference/legacy/crm/obje…, developers.hubspot.com/docs/api-reference/legacy/automati…, developers.hubspot.com/docs/api-reference/legacy/marketin…, developers.hubspot.com/docs/api-reference/legacy/account/…, docs.n8n.io/integrations/builtin/credentials/hubspot.

   Verbindungsname

   Ein beliebiger Name, den Sie später wiedererkennen werden, wie zum Beispiel die Vertriebsdatenbank.

   App-Zugriffstoken

   Ein HubSpot Private App-Token (beginnt mit pat-), zu finden unter Einstellungen, Integrationen, Private Apps, Ihre App, Registerkarte Authentifizierung.

   Klicken Sie auf TestverbindungWenn es liest Verbunden, klicken Speichern SieDie Verbindung erreicht Ihren Agenten innerhalb weniger Sekunden.

   Open-Data-Agenten

   Test fehlgeschlagen? Meist fehlt eine Berechtigung oder es werden Anmeldeinformationen des falschen HubSpot-Kontos verwendet. Die obige Anleitung listet die entsprechenden Schritte auf. häufige Probleme und deren Lösungen.

4. See your data in Query Builder Optional

   You can look at your HubSpot account before Google Sheets is involved at all. Open Abfrage-Generator in the portal and pick the connection you just made. The Schema tab lists your tables and columns, and clicking one puts its name in the editor, so you can write a query without remembering exact names. Click ausführen. and the rows appear under Ergebnisse. Query Builder is on every plan, Free included.

   On Business plans you can also ask Nova in plain English (“show me customers in the USA”) and it writes the SQL for you. When the query looks right, save it: from Personal Core up it shows in the add-on’s Saved Queries list, and on any plan you can copy the SQL into the next step.

5. Füge Abfrageströme zu Google Tabellen hinzu

   Öffne ein beliebiges Google Sheet und gehe zu Erweiterungen → Add-ons → Add-ons herunterladen, suchen nach Abfrageströmeund klicken Sie InstallierenOder installieren Sie es direkt von Abfragestreams auf dem Google Workspace MarketplaceGoogle wird Sie bitten, das Add-on zuzulassen; das ist normal.

   Anschließend ist es in jedem geöffneten Google Sheet zu finden: ein Query-Streams-Symbol in der Seitenleiste rechts, das auch unter folgendem Eintrag aufgeführt ist: ErweiterungenEs ist keine separate Anmeldung erforderlich. Das System erkennt Ihr bereits verwendetes Google-Konto, daher muss die E-Mail-Adresse diejenige Ihres Query Streams-Kontos sein.

6. Stellen Sie Ihren ersten Tisch auf

   Klicken Sie im Seitenbereich rechts im Arbeitsblatt auf das Symbol „Abfrageströme“ (oder suchen Sie es unter …). Erweiterungen). Wählen Abfragestreamer und wähle die soeben hergestellte Verbindung aus.

   Geben Sie die Abfrage ein, die Sie ausführen möchten. Diese Abfrage ruft einige Spalten aus einer Tabelle ab. hubspot.deals Tisch:

   Beispiel · SQL

   SELECT dealname, dealstage, amount, closedate FROM hubspot.deals ORDER BY closedate DESC LIMIT 100;

   Unter Zielblatt Wählen Sie den Tab aus, in dem die Zeilen landen sollen, und klicken Sie dann. Abfrage ausführenDie Zeilen erscheinen innerhalb von ein bis zwei Sekunden in diesem Tab. Klicken Sie erneut auf „Abfrage ausführen“, sobald sich die Daten geändert haben; der Tab wird dann entsprechend aktualisiert.

   Sie kennen sich nicht mit SQL aus? Build it in Abfrage-Generator first and paste it here, or pick it from Saved Queries if you saved it.

Gute nächste Schritte

• Abfrage speichern im Portal, sodass Sie es mit einem Klick erneut ausführen können, entweder aus Google Sheets oder Excel.
• Füge einen Filter hinzu wie beispielsweise ein Datumsbereich, sodass dieselbe Abfrage ohne Bearbeitung auch „diesen Monat“ beantworten kann.
• Ergebnisse teilen mit einem Kollegen. Dieser sieht die Zeilen, nicht Ihre Qualifikationsnachweise.

Fragen, die Menschen stellen

Verwandte Leitfäden

• HubSpot zu Microsoft Excel
• Stripe zu Google Tabellen
• Shopify zu Google Tabellen
• Google Analytics 4 zu Google Sheets
• Power Query für Google Sheets
• Alle Leitfäden