--- title: "Extrayez vos données CRM et marketing HubSpot" description: "Le connecteur HubSpot extrait les données de votre compte HubSpot : contacts, entreprises, transactions, tickets, pipelines, formulaires, e-mails marketing, et plus encore" url: https://docs.ovhcloud.com/fr/guides/public-cloud/data-platform/connectors-sources-hubspot lang: fr lastUpdated: 2026-09-14 --- > For AI agents: the complete documentation index is available at https://docs.ovhcloud.com/fr/llms.txt, the full documentation bundle is available at https://docs.ovhcloud.com/fr/llms-full.txt. # Extrayez vos données CRM et marketing HubSpot ## Objectif Le connecteur HubSpot extrait les données de votre compte HubSpot : contacts, entreprises, transactions, tickets, pipelines, formulaires, e-mails marketing, et plus encore. **25 types d'endpoints** couvrant l'ensemble de l'API HubSpot : CRM, Marketing, CMS, Automation et Settings. Le connecteur renvoie le **JSON brut** de l'API HubSpot. La platform aplatit automatiquement les objets imbriqués en colonnes et stocke le résultat dans le lakehouse. Aucune définition manuelle de schéma n'est nécessaire. :::info **Prérequis :** un compte HubSpot (le plan gratuit suffit pour l'accès à l'API. Aucun plan payant n'est requis) avec au moins quelques enregistrements de test (contacts, entreprises) afin d'avoir des données à extraire. Inscrivez-vous sur [app.hubspot.com/signup-hubspot/crm](https://app.hubspot.com/signup-hubspot/crm). ::: ## 1. Obtenir un token API ### Créer une Private App 1. Connectez-vous à HubSpot 2. Allez dans **Settings** (icône d'engrenage) > **Integrations** > **Private Apps** 3. Cliquez sur **Create a private app** 4. Donnez-lui un nom (par ex. `data-connector`) 5. Allez dans l'onglet **Scopes** et sélectionnez les permissions requises (voir la section suivante) 6. Cliquez sur **Create app** > **Continue creating** 7. Copiez le token généré (commence par `pat-na1-...` ou `pat-eu1-...`) :::info **Remarque :** les Private Apps peuvent apparaître dans une section « Legacy » de l'interface HubSpot, mais elles restent le standard pour les intégrations API côté serveur. Les « Personal Access Keys » ne fonctionnent que pour le HubSpot CLI, PAS pour l'API REST. ::: ### Configurer les identifiants Collez votre token dans le champ **Clé API HubSpot** : ``` pat-eu1-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx ``` ## 2. Scopes recommandés ### Scopes minimum (CRM de base) Pour extraire les contacts, entreprises, transactions et tickets : | Scope | Donne accès à | | ---------------------------- | -------------------------------------------------- | | `crm.objects.contacts.read` | Contacts, appels, e-mails, réunions, notes, tâches | | `crm.objects.companies.read` | Entreprises | | `crm.objects.deals.read` | Transactions + pipelines de transactions | | `tickets` | Tickets + pipelines de tickets | | `crm.schemas.contacts.read` | Propriétés des contacts | | `crm.schemas.companies.read` | Propriétés des entreprises | | `crm.schemas.deals.read` | Propriétés des transactions | ### Scopes supplémentaires (selon les besoins) | Scope | Donne accès à | | --------------------------------------- | ---------------------------------------- | | `forms` | Formulaires + soumissions de formulaires | | `content` | E-mails marketing | | `crm.lists.read` | Listes et segments | | `e-commerce` | Produits | | `crm.objects.line_items.read` | Lignes de produits | | `crm.objects.quotes.read` | Devis | | `crm.objects.feedback_submissions.read` | Soumissions de retours | | `crm.objects.leads.read` | Leads (Sales Hub Pro et supérieur) | :::tip Commencez avec les scopes minimum. Vous pouvez toujours en ajouter d'autres plus tard dans les paramètres de votre Private App. ::: ## 3. Types d'endpoints disponibles ### CRM (données relationnelles) | Endpoint | Description | Paramètres | | ---------------------------- | -------------------------------------------------------------- | -------------------------------------------- | | **crm\_objects** | 27 types d'objets CRM (contacts, entreprises, transactions...) | object\_type, properties\_filter, max\_items | | **associations** | Relations entre objets (contact->deal, company->contact...) | from\_type, to\_type, max\_items | | **association\_definitions** | Types de relations disponibles entre objets | from\_type, to\_type | | **pipelines** | Pipelines avec leurs étapes (transactions ou tickets) | pipeline\_object\_type | | **pipeline\_audit** | Journal d'audit d'un pipeline spécifique | pipeline\_object\_type, pipeline\_id | | **properties\_meta** | Schéma de propriétés d'un type d'objet | property\_object\_type | | **property\_groups** | Groupes de propriétés | property\_object\_type | | **lists** | Listes et segments | max\_items | | **list\_memberships** | ID des enregistrements membres d'une liste spécifique | list\_id, max\_items | ### Marketing | Endpoint | Description | Paramètres | | --------------------- | ----------------------------------------- | -------------------- | | **marketing\_emails** | Campagnes e-mail avec statistiques | max\_items | | **forms** | Définitions des formulaires | max\_items | | **form\_submissions** | Soumissions pour un formulaire spécifique | form\_id, max\_items | | **campaigns** | Campagnes marketing | max\_items | ### CMS (contenu) | Endpoint | Description | Paramètres | | ------------------ | ----------------------------------- | ---------- | | **blog\_posts** | Articles de blog | max\_items | | **site\_pages** | Pages du site web | max\_items | | **landing\_pages** | Landing pages | max\_items | | **hubdb\_tables** | Tables de données structurées HubDB | max\_items | ### Automation | Endpoint | Description | Paramètres | | ------------- | -------------------------- | ---------- | | **workflows** | Workflows d'automatisation | max\_items | | **sequences** | Séquences commerciales | max\_items | ### Settings / Admin | Endpoint | Description | Paramètres | | -------------------- | -------------------------------- | -------------------------------------------------- | | **users** | Utilisateurs du compte | max\_items | | **imports** | Historique des imports CRM | max\_items | | **crm\_schemas** | Schémas d'objets personnalisés | max\_items | | **custom\_events** | Événements comportementaux | event\_object\_type, event\_object\_id, max\_items | | **timeline\_events** | Modèles d'événements de timeline | app\_id | ## 4. Ajouter une source HubSpot sur Data Platform 1. Dans les **Connectors** de la Data Platform, trouvez **HubSpot** dans le source store et cliquez sur **Select**. 2. Collez le token Private App de l'[étape 1](#1-obtenir-un-token-api) dans le champ **Clé API HubSpot**. 3. Cliquez sur **Connect** pour vérifier les identifiants. 4. Cliquez sur **Add an Endpoint**, choisissez un type d'endpoint dans le menu déroulant (par ex. `crm_objects`), puis renseignez les paramètres requis par cet endpoint (par exemple `object_type: contacts`, un `properties_filter` optionnel, et un `max_items` optionnel). 5. Répétez l'étape 4 pour chaque endpoint supplémentaire que vous souhaitez ingérer dans cette source. Chaque endpoint devient une table distincte dans le lakehouse. 6. Nommez la source et cliquez sur **Create**. :::warning Le **nom technique** ne peut pas être modifié après la création de la source. Il est utilisé lors de l'ouverture de la source via le [SDK Python de la Data Platform](https://docs.ovhcloud.com/fr/guides/public-cloud/data-platform/landing-page-developers-python-sdk.md). ::: ## 5. Exemple rapide : extraire les contacts 1. **Endpoint** : `crm_objects` 2. **Object Type** : `contacts` 3. **Properties Filter** : `email, firstname, lastname, phone, company, jobtitle` 4. **Max Items** : `100` (ou vide pour tout extraire) Le connecteur renvoie le JSON brut de l'API HubSpot. La platform aplatit automatiquement les objets imbriqués (par ex. `properties.email` devient une colonne `properties_email`) et stocke le résultat dans le lakehouse. ## 6. Bonnes pratiques ### Utiliser le filtre de propriétés Par défaut, le connecteur utilise l'ensemble par défaut natif de HubSpot (6 champs principaux pour les contacts : email, firstname, lastname, createdate, lastmodifieddate, hs\_object\_id). Utilisez `properties_filter` pour choisir une liste spécifique de propriétés. ### Commencer avec max\_items Lors de la mise en place, définissez `max_items` à 10 ou 100 pour tester rapidement. Retirez la limite une fois satisfait du résultat. ### Les pipelines comme table de référence Extrayez les pipelines séparément pour obtenir une table de référence. Vous pouvez ensuite les joindre avec les transactions/tickets sur les champs pipeline et stage. ### Utiliser properties\_meta pour découvrir les champs L'endpoint `properties_meta` renvoie le dictionnaire de données complet pour n'importe quel type d'objet. Utile pour découvrir quels champs existent et leurs types. ## 7. Limites selon le plan HubSpot Certains endpoints nécessitent des plans payants : | Plan | Endpoints accessibles | | -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Free** | crm\_objects, pipelines, properties\_meta, forms, blog\_posts, site\_pages, landing\_pages, associations, property\_groups, lists, marketing\_emails, form\_submissions, pipeline\_audit, list\_memberships | | **Pro** | + workflows, sequences, users, campaigns | | **Enterprise** | + conversations, custom\_events, timeline\_events, crm\_schemas, hubdb\_tables, imports | Les endpoints non disponibles sur votre plan ou pour lesquels le scope requis est manquant renvoient une erreur 403. Le connecteur **n'intercepte pas** ces erreurs. L'extraction échouera avec une `HTTPError`. Assurez-vous que votre Private App dispose des scopes nécessaires avant de sélectionner un endpoint. :::info **Remarque :** la classification par plan ci-dessus est approximative. Certaines erreurs 403 peuvent être causées par des **scopes** manquants sur votre Private App plutôt que par des limitations de plan. Si un endpoint renvoie 403, vérifiez d'abord la configuration des scopes de votre Private App. ::: :::info Pour des informations techniques détaillées (internes de l'authentification, référence complète des endpoints, scopes, pagination, format de sortie, limitations), consultez la [référence technique HubSpot](https://docs.ovhcloud.com/fr/guides/public-cloud/data-platform/connectors-sources-hubspot-technical-reference.md). ::: ## Aller plus loin Si vous avez besoin d'une formation ou d'une assistance technique pour la mise en oeuvre de nos solutions, contactez votre commercial ou cliquez sur [ce lien](https://www.ovhcloud.com/fr/professional-services/) pour obtenir un devis et demander une analyse personnalisée de votre projet à nos experts de l’équipe Professional Services. Posez vos questions, faites-nous part de vos commentaires et interagissez directement avec l’équipe qui développe la Data Platform sur le [canal Discord](https://discord.gg/ovhcloud) dédié. Si vous avez besoin d'une assistance concernant vos services OVHcloud, créez une demande depuis notre [centre d'aide](https://help.ovhcloud.com/csm?id=csm_get_help). Rejoignez notre [communauté d'utilisateurs](https://community.ovhcloud.com/).