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, and this page is available as Markdown at https://docs.ovhcloud.com/fr/guides/public-cloud/data-platform/connectors-sources-hubspot.md.

Extrayez vos données CRM et marketing HubSpot

Voir en Markdown

Le connecteur HubSpot extrait les données de votre compte HubSpot : contacts, entreprises, transactions, tickets, pipelines, formulaires, e-mails marketing, et plus encore

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.

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 :

ScopeDonne accès à
crm.objects.contacts.readContacts, appels, e-mails, réunions, notes, tâches
crm.objects.companies.readEntreprises
crm.objects.deals.readTransactions + pipelines de transactions
ticketsTickets + pipelines de tickets
crm.schemas.contacts.readPropriétés des contacts
crm.schemas.companies.readPropriétés des entreprises
crm.schemas.deals.readPropriétés des transactions

Scopes supplémentaires (selon les besoins)

ScopeDonne accès à
formsFormulaires + soumissions de formulaires
contentE-mails marketing
crm.lists.readListes et segments
e-commerceProduits
crm.objects.line_items.readLignes de produits
crm.objects.quotes.readDevis
crm.objects.feedback_submissions.readSoumissions de retours
crm.objects.leads.readLeads (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)

EndpointDescriptionParamètres
crm_objects27 types d'objets CRM (contacts, entreprises, transactions...)object_type, properties_filter, max_items
associationsRelations entre objets (contact->deal, company->contact...)from_type, to_type, max_items
association_definitionsTypes de relations disponibles entre objetsfrom_type, to_type
pipelinesPipelines avec leurs étapes (transactions ou tickets)pipeline_object_type
pipeline_auditJournal d'audit d'un pipeline spécifiquepipeline_object_type, pipeline_id
properties_metaSchéma de propriétés d'un type d'objetproperty_object_type
property_groupsGroupes de propriétésproperty_object_type
listsListes et segmentsmax_items
list_membershipsID des enregistrements membres d'une liste spécifiquelist_id, max_items

Marketing

EndpointDescriptionParamètres
marketing_emailsCampagnes e-mail avec statistiquesmax_items
formsDéfinitions des formulairesmax_items
form_submissionsSoumissions pour un formulaire spécifiqueform_id, max_items
campaignsCampagnes marketingmax_items

CMS (contenu)

EndpointDescriptionParamètres
blog_postsArticles de blogmax_items
site_pagesPages du site webmax_items
landing_pagesLanding pagesmax_items
hubdb_tablesTables de données structurées HubDBmax_items

Automation

EndpointDescriptionParamètres
workflowsWorkflows d'automatisationmax_items
sequencesSéquences commercialesmax_items

Settings / Admin

EndpointDescriptionParamètres
usersUtilisateurs du comptemax_items
importsHistorique des imports CRMmax_items
crm_schemasSchémas d'objets personnalisésmax_items
custom_eventsÉvénements comportementauxevent_object_type, event_object_id, max_items
timeline_eventsModèles d'événements de timelineapp_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 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.

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 :

PlanEndpoints accessibles
Freecrm_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.

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 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 dédié.

Si vous avez besoin d'une assistance concernant vos services OVHcloud, créez une demande depuis notre centre d'aide.

Rejoignez notre communauté d'utilisateurs.

Cette page vous a-t-elle aidé ?