Récupérer des données à partir de HubSpot dans Google Sheets
Importez en temps réel les données de votre compte HubSpot dans Google Sheets et actualisez-les à votre guise. Aucun import CSV, aucun script Apps Script, aucun copier-coller. Une dizaine de minutes suffisent la première fois, et le forfait gratuit l'inclut.
Ce que vous obtiendrez
Une feuille Google Sheets affichant les résultats en direct d'une requête SQL sur votre compte HubSpot, avec un bouton permettant d'afficher les dernières lignes dès que les données changent. Par exemple :
| A | B | C | D | E | |
|---|---|---|---|---|---|
| 1 | numéro de client | prénom | nom de famille | pays | total |
| 2 | 1042 | Marie | 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 |
HubSpot stocke vos données via son API. Pour les importer dans Google Sheets, il faut généralement exporter un fichier CSV depuis le tableau de bord HubSpot à chaque fois que vous avez besoin de nouvelles données. Query Streams simplifie cette étape : un petit programme auxiliaire, appelé Agent, exécute la requête à l'emplacement de vos données, et une extension Google Sheets lui demande les lignes souhaitées. Seuls les résultats sont transférés, via une connexion chiffrée, et Google Sheets est accessible partout : depuis n'importe quel navigateur et sur n'importe quel appareil.
Ce dont vous aurez besoin
Un compte Query Streams
Le forfait gratuit suffit pour ce guide. Inscrivez-vous sur mon.querystreams.com.
L'agent sur n'importe quel ordinateur toujours allumé
Un petit programme qui s'exécute en arrière-plan et appelle HubSpot lorsque Google Sheets le demande. Il nécessite simplement une connexion internet.
Votre identifiant HubSpot
Vous vous connecterez à HubSpot une seule fois et autoriserez l'accès en lecture. Aucun mot de passe n'est saisi dans les flux de requêtes.
Quel ordinateur reçoit l'agent ? Toute machine toujours allumée qui peut déjà accéder à votre compte HubSpot. Google Sheets peut être partout; il s'exécute dans votre navigateur.
Connectez-le en cinq étapes
-
Créez votre compte
Aller à mon.querystreams.com et inscrivez-vous. Choisissez le Gratuit Ce forfait est définitif, il ne s'agit pas d'une version d'essai, et il inclut la connexion de votre compte HubSpot et l'exécution de requêtes depuis Google Sheets.
Installez l'agent sur n'importe quel ordinateur toujours allumé.



Connectez-vous, ouvrez TéléchargerInstallez ensuite l'agent sur n'importe quel ordinateur ou serveur toujours allumé et disposant d'un accès Internet. L'installation ne prend qu'une minute et l'agent s'exécute ensuite automatiquement.
Pourquoi un petit programme plutôt qu'un pilote ? L'Agent est une installation unique pour Windows, Mac ou Linux (environ 85 Mo sous Windows, un peu plus de 100 Mo sous Mac et Linux) qui fonctionne discrètement en arrière-plan. Il établit une connexion sortante chiffrée avec Query Streams, comme le ferait un navigateur ; vous n'avez donc pas besoin d'ouvrir de port dans votre pare-feu ni de configurer de VPN. Vos clés restent sur votre machine et les données sont transmises où que vous soyez, via Internet si nécessaire. Le seul élément requis de votre côté est l'extension.
La page de téléchargement affiche Votre clé d'accèsCollez-le dans l'Agent lorsqu'il vous le demande, et attendez que le badge affiche Connecté aux flux de requêtesC'est la seule chose que vous devez faire sur l'Agent lui-même.
Des guides complets sont disponibles si vous le souhaitez : Fenêtres, Mac, Linux.
-
Indiquez-lui l'adresse de votre compte HubSpot.
De retour dans votre navigateur, ouvrez Agents de données (sous Données (dans le menu du haut). Votre agent y est répertorié. Cliquez Ajouter un connecteur et choisissez HubSpotVous devez d'abord vous connecter avec vos identifiants HubSpot ? Ouvrez le guide, puis remplissez les champs :
Créez vos identifiants HubSpot (environ 5 minutes)
Ouvrez ensuite HubSpot dans un autre onglet. Query Streams conserve les éléments que vous créez ici afin que votre agent puisse les utiliser, et ne lit que les données provenant de HubSpot.
- Qui peut faire ça ?
- Un super administrateur ou un utilisateur disposant de l'autorisation d'accès aux outils de développement (clés de service) est requis. Les applications privées héritées nécessitent un super administrateur.
- Recommandé
- Clé de service avec accès en lecture seule (Développement → Clés → Clés de service). HubSpot recommande l'utilisation de clés de service pour la synchronisation planifiée des données avec les outils de BI et les entrepôts de données, et supprime la possibilité de créer de nouvelles applications privées héritées.
Avant de commencer
- Un compte HubSpot de super administrateur ou disposant de l'autorisation d'accès aux outils de développement est requis. Une clé de service ne peut se voir attribuer que les mêmes autorisations que votre utilisateur HubSpot.
- Sachez quel compte HubSpot vous souhaitez interroger. Une clé ne fonctionne que dans le compte où elle a été créée ; créez-la donc dans ce compte, et non dans un compte de test ou un environnement de test (sandbox).
- Choisissez les tables HubSpot que vous souhaitez inclure. Les tables Contacts, Entreprises, Transactions, Propriétaires, Pipelines, Étapes du pipeline et Propriétés sont activées par défaut ; chaque table supplémentaire nécessite ses propres autorisations de lecture (voir Autorisations).
- L'agent Query Streams est installé et en ligne sur un ordinateur toujours allumé, et le portail Query Streams est ouvert dans un autre onglet : Agents de données → Ajouter un connecteur → HubSpot.
Mesures
- Connectez-vous à HubSpot
Ouvrez HubSpot dans un nouvel onglet et connectez-vous en tant que super administrateur ou en tant qu'utilisateur disposant de l'autorisation d'accès aux outils de développement.
Si vous possédez plusieurs comptes HubSpot, veuillez sélectionner celui dont vous souhaitez accéder aux données avant de poursuivre. La clé n'est valable que pour le compte dans lequel elle a été créée.
- Développement ouvert
Dans le menu de navigation principal à gauche, en bas, cliquez sur Développement (l'icône </>). La page Développement s'ouvre avec sa propre barre latérale : Vue d'ensemble, Projets, Applications existantes, Surveillance, Clés et plus encore.
Aucun élément de développement ? Votre utilisateur HubSpot n'est pas un super administrateur et n'a pas accès aux outils de développement. Demandez à un super administrateur de créer la clé ou de vous accorder cette autorisation.
- Clés de service ouvertes
Dans la barre latérale Développement, cliquez sur Clés pour la développer, puis sur Clés de service (indiquées par un badge Bêta). La page Clés de service s'ouvre ; si vous n'en avez aucune, le message « Aucune clé de service créée » s'affiche.
N’utilisez pas la clé d’accès personnelle ni la clé API développeur, qui se trouvent juste au-dessus des clés de service dans le même menu. Ce sont des clés d’outils de développement et elles ne permettront pas de se connecter. Certains comptes accèdent également à cette page via Paramètres (icône d’engrenage) → Intégrations → Clés de service.
- Cliquez sur « Créer une clé de service ».
En haut à droite de la page Clés de service, cliquez sur Créer une clé de service. La page Créer une clé de service s'ouvre et comporte un champ Nom et une section Étendues.
- Nommez la clé
Dans le champ Nom, saisissez un nom que vous reconnaîtrez ultérieurement, par exemple « Flux de requêtes en lecture seule ». HubSpot affiche ce nom dans ses journaux.
Le nom doit être unique dans votre compte HubSpot.
- Ouvrir le sélecteur de portée
À côté de « Étendues sélectionnées », cliquez sur « + Ajouter une nouvelle étendue ». Un panneau s'ouvre à droite avec un champ de recherche « Trouver une étendue » et une case à cocher pour chaque étendue.
- Cochez les quatre champs d'application requis
Saisissez chaque nom dans le champ « Trouver une étendue » et cochez la case correspondante : crm.objects.contacts.read, crm.objects.companies.read, crm.objects.deals.read, crm.objects.owners.read. Ces quatre étendues couvrent toutes les tables synchronisées par défaut par Query Streams.
Cochez uniquement les autorisations se terminant par .read. Query Streams ne lit que les données HubSpot ; il n’a jamais besoin d’autorisation .write.
- Établissez les portées des ticks pour toutes les tables supplémentaires
Pour chaque table supplémentaire souhaitée, cochez son étendue dans la liste des autorisations ci-dessous. Par exemple : crm.objects.tickets.read pour les tickets ; crm.objects.line_items.read pour les lignes de commande, les taxes, les remises et les frais ; crm.lists.read pour les listes. Ignorez cette étape si les tables par défaut vous suffisent.
Vous pouvez ajouter des portées ultérieurement sans créer une nouvelle clé (ouvrez la clé, puis Modifier).
- Cliquez sur Mettre à jour
Cliquez sur « Mettre à jour » dans le panneau de droite. Le panneau se ferme et vos étendues apparaissent sous « Étendues sélectionnées ».
- Consultez la liste des portées
Parcourez les étendues sélectionnées. Si une étendue se termine par .write, cliquez sur Supprimer à côté. Développez le résumé des étendues sélectionnées pour obtenir une liste en langage clair des éléments auxquels la clé a accès.
- Créez la clé
Cliquez sur « Créer » en haut à droite, puis confirmez dans la boîte de dialogue qui s'ouvre.
- Ouvrez votre nouvelle clé
Accédez à Développement → Clés → Clés de service et cliquez sur le nom de la clé que vous venez de créer. Sa page de détails s'ouvre avec un champ Clé de service.
- Afficher et copier la clé
Dans le champ Clé de service, la valeur est partiellement masquée et commence par pat- (par exemple pat-na1-…). Cliquez sur Afficher en dessous, puis sur Copier.
Utilisez la fonction Copier plutôt que de sélectionner le texte manuellement : un caractère manquant, un espace en fin de chaîne ou des points cachés entraîneront l’échec du test. HubSpot n’affiche la clé qu’une seule fois ; vous pouvez revenir en arrière et cliquer à nouveau sur Afficher. Considérez-la comme un mot de passe.
- Collez-le dans Query Streams et testez.
Dans le portail Query Streams, ouvrez Agents de données, cliquez sur Ajouter un connecteur et sélectionnez HubSpot. Collez la clé dans Jeton d'accès à l'application, saisissez un nom de connexion, puis cliquez sur Tester la connexion. Le résultat indique « Connecté ».
Query Streams stocke la clé de votre agent et ne lit que vos données HubSpot.
- Faites correspondre les tableaux à vos portées
À l'étape de synchronisation suivante, ne laissez que les tables HubSpot dont vous avez coché les étendues aux étapes 7 et 8, puis terminez l'assistant.
Une table activée sans son étendue ne peut pas se synchroniser et une erreur « Accès interdit » s'affiche. Ajoutez l'étendue à la clé (étape 8) ou désactivez la table.
Alternatives
Utilisez un jeton d'application privé hérité
Votre compte possède déjà une application privée que vous souhaitez réutiliser. HubSpot supprime la possibilité d'en créer de nouvelles : les comptes créés à partir du 28 septembre 2026 ne le permettent déjà plus, et les comptes plus anciens le perdront le 26 octobre 2026. Les applications privées existantes et leurs jetons restent fonctionnels.
Qui peut faire cela : Super administrateur
- Ouvrir les applications héritées
Dans HubSpot, cliquez sur Développement dans le menu de navigation principal à gauche, puis sur Applications héritées dans la barre latérale Développement.
L'ancienne navigation HubSpot appelait cela Paramètres → Intégrations → Applications privées.
- Ouvrez votre application privée ou créez-en une nouvelle.
Si l'application est listée, cliquez sur son nom et passez à l'étape 6 (ou à l'étape 5 pour ajouter des autorisations). Sinon, si le bouton est toujours présent, cliquez sur « Créer une application héritée » en haut à droite et choisissez « Privée » dans la boîte de dialogue.
L'absence du bouton « Créer une application héritée » signifie que la création d'applications héritées est désactivée pour votre compte. Utilisez plutôt une clé de service (étapes principales).
- Nommez la nouvelle application
Dans l'onglet Informations de base, saisissez un nom tel que « Flux de requêtes en lecture seule ». Le logo et la description sont facultatifs.
- Ajouter les portées de lecture
Cliquez sur l'onglet « Étendues », puis sur « Ajouter une étendue », cochez les mêmes étendues qu'aux étapes 7 et 8, puis cliquez sur « Mettre à jour ». Cliquez ensuite sur « Créer une application » en haut à droite, lisez le message relatif au jeton d'accès dans la boîte de dialogue et cliquez sur « Continuer la création ».
- Ajouter des étendues à une application existante (uniquement si nécessaire)
Sur la page de l'application, cliquez sur « Modifier l'application » en haut à droite, ouvrez l'onglet « Autorisations », ajoutez les autorisations de lecture manquantes et enregistrez. La chaîne de caractères du jeton reste inchangée lorsque vous modifiez les autorisations.
- Afficher et copier le jeton
Sur la page de l'application, cliquez sur l'onglet Authentification. Sous Jeton d'accès, cliquez sur Afficher le jeton, puis sur Copier. Le jeton commence par pat-. Collez-le dans le champ Jeton d'accès à l'application, comme à l'étape 14.
Si l'utilisateur HubSpot ayant créé l'application est supprimé de HubSpot, certains appels échouent avec l'erreur USER_DOES_NOT_HAVE_PERMISSIONS. Renouvelez le jeton (bouton de renouvellement à côté) et collez le nouveau, ou utilisez une clé de service.
Utilisez le jeton d'authentification statique d'une application de plateforme de développement
Votre équipe a déjà créé une application HubSpot sur la nouvelle plateforme de développement avec l'interface de ligne de commande HubSpot (CLI), configurée avec une authentification statique et une distribution privée. La création d'une application nécessite la CLI ; si vous n'en possédez pas, utilisez une clé de service.
Qui peut faire cela : L'administrateur principal ou un utilisateur disposant d'un compte développeur doit pouvoir consulter le jeton ; l'administrateur principal ou l'autorisation d'accès à la Marketplace HubSpot doit être requis pour installer l'application.
- Ouvrir le projet
Dans HubSpot, cliquez sur Développement, puis sur Projets dans la barre latérale, puis sur le nom du projet qui contient votre application.
- Ouvrez l'application
Dans l'onglet Vue d'ensemble du projet, sous Composants du projet, cliquez sur le nom de l'application.
- Ouvrez l'onglet Distribution
Cliquez sur l'onglet Distribution.
- Installez l'application si elle ne l'est pas encore.
Sous « Gérer la distribution », votre compte HubSpot actuel est répertorié. Cliquez sur « Installer maintenant », vérifiez que l’accès demandé correspond aux autorisations de lecture que vous avez configurées, puis cliquez sur « Connecter l’application ».
Une application à jeton statique ne peut être installée que sur un seul compte HubSpot standard à la fois.
- Afficher et copier le jeton
Une fois l'installation terminée, l'onglet Distribution affiche un jeton d'accès. Cliquez sur Afficher pour le révéler, copiez-le et collez-le dans Jeton d'accès à l'application, comme à l'étape 14.
Si vous modifiez ultérieurement les autorisations de l'application, réinstallez-la à l'aide de l'URL de réinstallation disponible dans l'onglet Distribution, sinon les nouvelles autorisations ne seront pas prises en compte.
Autorisations à accorder
Ressource Accès Utilisé pour crm.objets.contacts.lire Lire Obligatoire. hubspot.contacts, ainsi que les tables d'activité hubspot.calls, hubspot.emails, hubspot.meetings, hubspot.notes, hubspot.tasks et hubspot.communications (les API d'activité de HubSpot utilisent cette portée), et les champs de contact dans hubspot.properties et hubspot.associations. crm.objets.entreprises.lire Lire Obligatoire. hubspot.companies, et les champs d'entreprise dans hubspot.properties et hubspot.associations. crm.objets.transactions.lecture Lire Obligatoire. hubspot.deals, les pipelines de transactions dans hubspot.pipelines et hubspot.pipeline_stages, et les champs de transactions dans hubspot.properties et hubspot.associations. crm.objets.propriétaires.lecture Lire Obligatoire. hubspot.owners, les utilisateurs HubSpot propriétaires des enregistrements, permettant ainsi d'associer les transactions et les contacts au nom d'un représentant. crm.objects.tickets.read Lire Uniquement si vous synchronisez les tickets (hubspot.tickets) et les pipelines de tickets (hubspot.pipelines et hubspot.pipeline_stages). Les applications plus anciennes peuvent afficher l'ancienne portée des tickets, qui permet également des modifications. crm.objects.products.read Lire Uniquement si vous synchronisez les produits : hubspot.products. Recherchez les produits dans le sélecteur ; l’API des produits HubSpot accepte cette étendue, même si elle n’est pas encore mentionnée dans la page de référence des étendues HubSpot. crm.objects.line_items.read Lire Uniquement si vous synchronisez les éléments de ligne, les taxes, les remises ou les frais : hubspot.line_items, hubspot.taxes, hubspot.discounts, hubspot.fees. crm.objects.quotes.read Lire Uniquement si vous synchronisez les citations : hubspot.quotes. crm.objects.invoices.read Lire Uniquement si vous synchronisez les factures : hubspot.invoices. crm.objects.subscriptions.read Lire Uniquement si vous synchronisez les abonnements : hubspot.subscriptions (abonnements HubSpot Commerce). crm.objects.commercepayments.read Lire Uniquement si vous synchronisez les paiements : hubspot.payments (paiements HubSpot Commerce). crm.objects.marketing_events.read Lire Uniquement si vous synchronisez les événements marketing : hubspot.marketing_events. formulaires Lecture et écriture (HubSpot ne dispose d'aucun accès en lecture seule aux formulaires) Uniquement si vous synchronisez les formulaires ou les soumissions de formulaires : hubspot.forms et hubspot.form_submissions. Query Streams ne fait que les lire. crm.objects.feedback_submissions.read Lire Uniquement si vous synchronisez les commentaires : hubspot.feedback_submissions. Service Hub Professional ou Enterprise uniquement. La documentation HubSpot indique « crm.objects.feedback_submission.read », recherchez donc « feedback » dans le sélecteur. crm.lists.read Lire Uniquement si vous synchronisez les listes : hubspot.lists. automatisation Lecture et écriture (HubSpot ne propose pas de flux de travail en lecture seule) Uniquement si vous synchronisez les workflows : hubspot.workflows. Comptes Professional ou Enterprise uniquement. Query Streams lit uniquement les définitions de workflow. crm.schemas.custom.read Lire Uniquement si vous synchronisez les schémas personnalisés : hubspot.schemas (définitions d’objets personnalisés). Comptes Entreprise uniquement. Coller dans les flux de requêtes
- Jeton d'accès à l'application
- La clé de service que vous avez copiée à l'étape 13 (elle commence par pat-), ou un jeton d'application privé hérité, ou le jeton d'authentification statique d'une application de plateforme de développement
Problèmes courants
La connexion de test échoue avec le message « Jeton d'accès invalide ou expiré », juste après avoir collé une nouvelle clé.
Pourquoi: Cette valeur n'est ni une clé d'application ni une clé de service. Il faut généralement la confondre avec la clé d'accès personnelle ou la clé API développeur, qui se trouvent à côté des clés de service dans Développement → Clés et sont destinées aux outils de développement HubSpot.
Réparer: Accédez à Développement → Clés → Clés de service, ouvrez votre clé, cliquez sur Afficher, puis sur Copier et collez-la dans le champ Jeton d'accès à l'application. Testez à nouveau la connexion ; elle devrait s'établir.
L'assistant indique que le jeton d'application HubSpot n'est pas valide avant même d'effectuer un test.
Pourquoi: Seule une partie de la légende a été collée : le texte ne commence pas par « pat- » et est très court ou contient un espace.
Réparer: De retour dans HubSpot, cliquez sur Afficher, puis utilisez le lien Copier (ne sélectionnez pas le texte manuellement) et collez-le à nouveau.
Vous ne voyez pas l'option Développement dans le menu de navigation de gauche de HubSpot, ou l'option Clés de service est absente sous Clés.
Pourquoi: Votre utilisateur HubSpot n'est pas un super administrateur et ne dispose pas de l'autorisation d'accès aux outils de développement.
Réparer: Demandez à un super administrateur de votre entreprise de créer la clé (étapes 2 à 13) et de la coller dans l'assistant, ou de vous accorder l'accès aux outils de développement.
Le test de connexion indique « Connecté », mais une table ne parvient pas à se synchroniser (erreur « Interdit ») ou reste vide.
Pourquoi: Le problème vient de l'absence de l'autorisation de lecture pour cette table, ou du fait que votre forfait HubSpot n'inclut pas cette fonctionnalité (Workflows nécessite Professional ou Enterprise ; Custom Schemas nécessite Enterprise ; Feedback nécessite Service Hub Professional ou Enterprise).
Réparer: Ouvrez la clé (Développement → Clés → Clés de service → nom de la clé), cliquez sur Modifier, ajoutez l'étendue depuis la liste des autorisations et enregistrez, puis synchronisez à nouveau. Si votre forfait ne comprend pas cette fonctionnalité, désactivez ce tableau dans les paramètres de synchronisation de la connexion.
Les synchronisations qui fonctionnaient auparavant commencent à échouer avec le message « Jeton d'accès invalide ou expiré ».
Pourquoi: La clé a été modifiée ou supprimée. L'option « Renouveler et expirer maintenant » désactive immédiatement l'ancienne clé ; l'option « Renouveler et expirer plus tard » la désactive après 7 jours.
Réparer: Copiez la clé actuelle depuis Développement → Clés → Clés de service → nom de la clé → Afficher → Copier. Dans Agents de données, modifiez la connexion HubSpot, collez-la dans le champ Jeton d'accès à l'application et exécutez Tester la connexion.
Avec un jeton d'application privée hérité, certaines tables échouent avec l'erreur USER_DOES_NOT_HAVE_PERMISSIONS.
Pourquoi: L'utilisateur HubSpot qui a créé l'application privée a été supprimé du compte.
Réparer: Faites pivoter le jeton de l'application (Développement → Applications héritées → application → Rotation) et collez le nouveau jeton dans la connexion, ou créez plutôt une clé de service.
Vous ne trouvez pas l'option « Créer une application héritée », ni la documentation de HubSpot qui qualifie les applications privées d'héritières.
Pourquoi: HubSpot met fin à la création de nouvelles applications privées héritées (déjà désactivée pour les comptes créés à partir du 28 septembre 2026 ; désactivée pour les comptes plus anciens à partir du 26 octobre 2026). Les applications privées existantes restent fonctionnelles.
Réparer: Créez une clé de service (étapes principales). Les jetons d'application privés existants peuvent être conservés.
Les données affichées dans Query Streams ne correspondent pas à celles affichées dans HubSpot.
Pourquoi: La clé a été créée dans un autre compte HubSpot (par exemple un compte de test ou de bac à sable).
Réparer: Basculez vers le bon compte HubSpot, créez-y une clé et collez-la dans la connexion.
Limites à connaître
- HubSpot impose des limites aux clés de service et aux applications privées : 100 requêtes toutes les 10 secondes par clé pour les versions Free et Starter, 190 pour les versions Professional et Enterprise, et 250 avec l’extension API Limit Increase. L’Agent fonctionne selon la limite la plus basse, ce qui peut rendre la première synchronisation complète d’un CRM volumineux assez longue.
- Limite quotidienne par compte HubSpot : 250 000 requêtes pour les versions Free et Starter, 625 000 pour la version Professional et 1 000 000 pour la version Enterprise. Cette limite est partagée par toutes les applications privées et clés de service du compte ; les autres intégrations utilisent donc le même budget.
- La recherche CRM de HubSpot, que l'agent utilise pour récupérer uniquement les enregistrements modifiés, autorise 5 requêtes par seconde et par compte, et au maximum 10 000 résultats par requête.
- Certaines tables dépendent de votre forfait HubSpot : Workflows (Professional ou Enterprise), Custom Schemas (Enterprise), Feedback (Service Hub Professional ou Enterprise).
- Les clés de service sont en version bêta publique (depuis le 10 février 2026), HubSpot est donc susceptible d'en modifier les détails. HubSpot recommande de renouveler ses clés tous les six mois.
- Il est impossible de créer de nouvelles applications privées héritées sur les comptes créés à partir du 28 septembre 2026, ni sur les comptes plus anciens datant du 26 octobre 2026. Les applications et jetons existants continuent de fonctionner.
Étapes vérifiées le 8 octobre 2026. Sources : developers.hubspot.com/docs/apps/developer-platform/build…, developers.hubspot.com/changelog/service-keys, developers.hubspot.com/blog/hubspot-service-keys-the-right…, developers.hubspot.com/changelog/legacy-private-app-create…, 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.
- Nom de la connexion
- Un nom que vous reconnaîtrez plus tard, comme base de données des ventes.
- Jeton d'accès à l'application
- Un jeton d'application privée HubSpot (il commence par pat-), que vous trouverez dans Paramètres, Intégrations, Applications privées, votre application, onglet Authentification.
Cliquez sur Test de connexion.Quand il lit Connecté, cliquez ÉconomiserLa connexion atteint votre agent en quelques secondes.
Test échoué ? Il s'agit généralement d'une autorisation manquante ou d'identifiants provenant d'un compte HubSpot incorrect. La procédure détaillée ci-dessus répertorie les problèmes courants et leurs solutions.
-
See your data in Query Builder Facultatif
You can look at your HubSpot account before Google Sheets is involved at all. Open Générateur de requêtes in the portal and pick the connection you just made. The Schéma 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 Exécuter and the rows appear under Résultats. 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.
-
Ajouter des flux de requêtes à Google Sheets
Ouvrez n'importe quelle feuille Google, allez à Extensions → Modules complémentaires → Télécharger des modules complémentaires, Rechercher Flux de requêtes, et cliquez InstallerOu installez-le directement depuis Flux de requêtes sur la place de marché Google WorkspaceGoogle vous demandera d'autoriser l'extension ; c'est normal.
Ensuite, dans chaque feuille Google que vous ouvrez, vous trouverez une icône Query Streams dans le panneau latéral droit, également répertoriée sous ExtensionsIl n'y a pas de connexion séparée. Le système reconnaît le compte Google que vous utilisez déjà ; l'adresse e-mail doit donc être celle associée à votre compte Query Streams.
-
Installez votre première table
Cliquez sur l'icône Flux de requêtes dans le panneau latéral à droite de la feuille (ou trouvez-la sous Extensions). Choisir Flux de requêtes et sélectionnez la connexion que vous venez d'établir.
Saisissez la requête que vous souhaitez exécuter. Celle-ci extrait quelques colonnes d'une base de données. hubspot.offres tableau:
Exemple · SQLSELECT dealname, dealstage, amount, closedate FROM hubspot.deals ORDER BY closedate DESC LIMIT 100;
Sous Fiche de destination Sélectionnez l'onglet dans lequel les lignes doivent apparaître, puis cliquez. Exécuter une requêteLes lignes s'affichent dans cet onglet en une ou deux secondes. Cliquez à nouveau sur « Exécuter la requête » dès que les données changent ; l'onglet se met alors à jour.
Vous ne connaissez pas SQL ? Build it in Générateur de requêtes first and paste it here, or pick it from Saved Queries if you saved it.
C'est ça. Vos données sont dans la feuille et restent à jour en un clic. Seules les lignes que vous avez demandées ont quitté votre réseau.
Bonnes prochaines étapes
- Enregistrer la requête dans le portail, vous pouvez donc le relancer en un seul clic, depuis Google Sheets ou Excel.
- Ajouter un filtre par exemple, une plage de dates, afin que la même requête puisse répondre « ce mois-ci » sans modification.
- Partagez les résultats avec un collègue. Il voit les rangs, pas vos qualifications.
Questions que se posent les gens
Mon compte HubSpot doit-il obligatoirement être installé sur l'ordinateur sur lequel j'utilise Sheets ?
Non. Seul l'application Agent doit être installée sur le même ordinateur que votre compte HubSpot. Google Sheets fonctionne dans votre navigateur, quel que soit votre appareil. Ouvrez l'extension avec le même compte Google et vos connexions seront disponibles.
Mes données sont-elles copiées dans Query Streams ?
Non. L'agent exécute la requête à l'endroit où se trouvent vos données et n'envoie que les lignes renvoyées. Aucune donnée n'est synchronisée ni stockée entre-temps.
Le forfait gratuit couvre-t-il vraiment cela ?
Oui. L'offre gratuite est un abonnement permanent, et non une période d'essai. Consultez les détails sur son contenu. page de tarification.
La feuille de calcul se met-elle à jour automatiquement ?
Cliquez à nouveau sur « Exécuter la requête » pour afficher les dernières lignes. Pour une feuille qui s'actualise automatiquement, configurez une automatisation dans le portail Query Streams (Flux → Automatisation). Cette fonctionnalité est incluse dans tous les abonnements.
Guides associés
Chaque guide pour HubSpot
Setup trouble?
- Agent shows Offline, or Test connection and Browse are greyed out? Check that the Agent is online → Is the Agent online?

