De quel forfait HubSpot ai-je besoin ?

N'importe quel forfait HubSpot convient : gratuit, Starter, Professionnel ou Entreprise.

Mes données HubSpot sont-elles sécurisées ?

Oui. Cryptage AES-256, connexions sortantes uniquement, les données ne transitent jamais par les serveurs Query Streams.

Puis-je accéder aux propriétés HubSpot personnalisées ?

Oui — utilisez json_extract_string(raw_data, '$.properties.your_custom_field') pour accéder à n'importe quelle propriété.

Les flux de requêtes peuvent-ils modifier mes données HubSpot ?

Non. Query Streams est strictement en lecture seule et ne demande que des autorisations .read.

Connectez HubSpot à Excel - Interrogez les données CRM avec SQL

Connexion · HubSpot à Excel

Récupérer des données à partir de HubSpot dans Excel

Importez en temps réel les données de votre compte HubSpot dans Excel et actualisez-les à votre guise. Aucun pilote ODBC, aucune exportation, aucune macro. Une dizaine de minutes suffisent la première fois ; le forfait gratuit l'inclut.

Environ 10 minutes Aucun codage nécessaire Vos identifiants vous suivent. Exceller partout, même sur le web

Vous êtes bloqué à un moment donné ? N'hésitez pas à nous demander. Ouvrir Soutien Dans la section « Flux de requêtes » (menu en haut à droite → Assistance), envoyez-nous un message. De vraies personnes le liront, et « Je ne comprends pas ce que cet écran demande » est une question tout à fait légitime.

Ce que vous obtiendrez

Une feuille de calcul 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 :

Ventes.xlsx — Excel

AccueilInsérerDonnéesFlux de requêtes

	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

Feuille1

En direct de HubSpot

HubSpot stocke vos données via son API. Pour les importer dans Excel, il faut généralement exporter un fichier CSV depuis le tableau de bord HubSpot à chaque fois que vous avez besoin de données actualisées. Query Streams simplifie cette étape : un petit programme auxiliaire, appelé Agent, exécute la requête à l'emplacement de vos données, et un complément Excel lui demande les lignes souhaitées. Seuls les résultats sont transférés, via une connexion chiffrée, et Excel peut être ouvert n'importe où : sur votre ordinateur portable à la maison, sur celui d'un collègue à l'autre bout du pays, ou encore via Excel sur le web.

L'Agent est intégré à vos données. Excel, lui, n'en a pas besoin. Ouvrez la feuille n'importe où et les lignes s'affichent.

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 lorsqu'Excel 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. Excel peut être partout, y compris Excel sur le Web.

Connectez-le en cinq étapes

Créez votre compte

Aller à mon.querystreams.com et inscrivez-vous. Choisissez le Gratuit Ce forfait est définitif et non une version d'essai. Il comprend la connexion de votre compte HubSpot et l'exécution de requêtes depuis Excel.
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 s'installe en une seule étape sur Windows, Mac ou Linux (environ 85 Mo sous Windows, un peu plus de 100 Mo sous Mac et Linux) et 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. Seul le module complémentaire est requis de votre côté.
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.

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.

Agents de données ouvertes

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 Excel 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-in’s Saved Queries list, and on any plan you can copy the SQL into the next step.
Ajouter des flux de requêtes à Excel

Dans Excel, accédez à Insérer → Obtenir des compléments, Rechercher Flux de requêtes, et cliquez AjouterOu ouvrez-le directement depuis Flux de requêtes sur Microsoft AppSourceUn bouton « Flux de requêtes » apparaît dans le ruban. Connectez-vous avec le même compte.

Fonctionne dans Excel pour Microsoft 365 sur Windows et Mac, et dans Excel sur le Web.
Installez votre première table

Cliquez sur le bouton « Interroger les flux », choisissez Diffuser une requête, 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 · SQL
```
SELECT dealname, dealstage, amount, closedate FROM hubspot.deals ORDER BY closedate DESC LIMIT 100;
```
Sous Fiche de destination choisir Créer une nouvelle feuilleAppuyez ensuite sur le bouton Lecture (la flèche ▶). Les lignes s'affichent dans Excel en une ou deux secondes. Appuyez de nouveau sur le bouton dès que les données changent ; la feuille se met à jour automatiquement.

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 Excel ou Google Sheets.
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

Excel doit-il être installé sur le même ordinateur que votre compte HubSpot ?

Non. Seul l'application Agent doit être installée sur le même ordinateur que votre compte HubSpot. Excel peut être installé sur n'importe quel ordinateur connecté à Internet, y compris Excel sur le Web et Excel sur Mac. Connectez-vous à l'extension avec votre compte 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.

Est-ce compatible avec Excel pour Mac ?

Oui. Excel pour Microsoft 365 sur Mac et Windows, et Excel sur le Web.

Toujours bloqué ? Ouvrir Soutien Dans Query Streams, indiquez-nous l'étape à laquelle vous vous trouvez et ce que vous voyez. Nous vous mettrons en relation.

Créez votre compte de forfait gratuit Découvrez ce que comprend la version gratuite.