Intégration API HubSpot : centralisez vos données marketing et CRM – Guide 2025

1. 1. Pourquoi intégrer HubSpot via API ? Les enjeux pour vos équipes marketing et sales
2. 2. Présentation technique des APIs HubSpot (CRM, Marketing, Automation, Webhooks...)
3. 3. Authentification et sécurité : API Keys, OAuth 2.0 et scopes HubSpot
4. 4. Modèle de données HubSpot : contacts, entreprises, deals et propriétés personnalisées
5. 5. Connecter HubSpot à vos outils externes (ERP, e-commerce, support, BI)
6. 6. Automatiser les workflows HubSpot via API : exemples pratiques et code
7. 7. Synchroniser HubSpot avec votre CRM ou Data Hub existant
8. 8. Exploiter les Webhooks HubSpot pour la donnée en temps réel
9. 9. Bonnes pratiques techniques : quotas, pagination, versioning et erreurs API
10. 10. Monitoring et logs : superviser vos intégrations HubSpot
11. 11. Sécurité, conformité et RGPD dans vos intégrations HubSpot
12. 12. KPI & ROI : mesurer la performance d’une intégration HubSpot réussie
13. 13. Autres solutions du marché
14. Passez à l’action avec Dawap

1. Pourquoi intégrer HubSpot via API ? Les enjeux pour vos équipes marketing et sales

HubSpot est bien plus qu’un simple CRM : c’est une plateforme marketing, commerciale et service client conçue pour unifier vos données et automatiser vos processus. Mais pour tirer pleinement parti de son potentiel, il est essentiel d’intégrer HubSpot via ses APIs. Ces interfaces permettent de connecter HubSpot à vos outils internes (ERP, site e-commerce, marketing automation, support, BI...) et d’aligner marketing et ventes autour d’une donnée unique.

Un HubSpot connecté, c’est un CRM qui ne travaille plus en silo

Sans intégration API, les données clients restent fragmentées : vos formulaires web, vos campagnes marketing et vos opportunités commerciales ne se synchronisent pas toujours correctement. Grâce à l’API HubSpot, chaque interaction – lead généré, deal créé, email ouvert – devient un événement exploitable en temps réel. Résultat : vos équipes disposent d’une vue 360° du client et peuvent coordonner leurs actions sans perte d’information.

Des bénéfices concrets à tous les niveaux

Intégrer HubSpot via API, c’est automatiser les tâches répétitives, fiabiliser les échanges de données et réduire les frictions entre équipes. L’intégration devient un véritable levier de performance commerciale et marketing.

Exemple concret : synchronisation automatique des leads

Voici un exemple d’appel API permettant d’ajouter automatiquement un contact depuis votre site web dans HubSpot CRM lors d’un envoi de formulaire :

POST https://api.hubapi.com/crm/v3/objects/contacts
Authorization: Bearer YOUR_ACCESS_TOKEN
Content-Type: application/json

{
  "properties": {
    "email": "client@example.com",
    "firstname": "Thomas",
    "lastname": "Durand",
    "company": "TechFlow",
    "lifecyclestage": "lead"
  }
}
        

Ce type d’intégration simplifie considérablement la gestion des prospects : dès qu’un formulaire est rempli sur votre site, le lead est créé dans HubSpot, assigné automatiquement à un commercial et intégré dans vos workflows marketing.

En somme, connecter HubSpot via API, c’est transformer votre CRM en une plateforme intelligente et interconnectée, au service de la performance de vos équipes marketing et sales.

2. Présentation technique des APIs HubSpot (CRM, Marketing, Automation, Webhooks...)

HubSpot propose un écosystème d’APIs extrêmement complet, permettant d’interagir avec tous les modules de la plateforme : CRM, Marketing, Automations, Tickets, CMS, et Webhooks. Ces APIs reposent principalement sur le protocole REST et permettent à vos développeurs d’intégrer HubSpot à n’importe quelle application externe.

Structure générale et principes d’appel

Toutes les APIs HubSpot sont accessibles via HTTPS sur https://api.hubapi.com et utilisent les méthodes standards GET, POST, PATCH et DELETE. Les données échangées sont au format JSON, et l’accès se fait via OAuth 2.0 ou via un token privé (Private App Token).

GET https://api.hubapi.com/crm/v3/objects/contacts?limit=5
Authorization: Bearer YOUR_ACCESS_TOKEN
        

Cet appel récupère les 5 premiers contacts de votre compte HubSpot. Les réponses incluent les propriétés standard (email, prénom, entreprise, etc.) ainsi que toutes les propriétés personnalisées définies dans votre CRM.

1️⃣ API CRM – gestion des objets principaux

L’API CRM de HubSpot est la base du système. Elle permet de manipuler les objets principaux : contacts, entreprises, deals, produits et tickets. Vous pouvez créer, mettre à jour, ou supprimer n’importe quel enregistrement, mais aussi gérer les associations entre objets.

POST https://api.hubapi.com/crm/v3/objects/deals
Authorization: Bearer YOUR_ACCESS_TOKEN
Content-Type: application/json

{
  "properties": {
    "dealname": "Nouveau projet CRM",
    "amount": "25000",
    "pipeline": "default",
    "dealstage": "appointmentscheduled"
  }
}
        

Cette requête crée une nouvelle opportunité dans votre pipeline HubSpot. L’API CRM offre aussi des endpoints pour la recherche avancée (/search), les associations (/associations) et la mise à jour en masse (/batch).

2️⃣ API Marketing – automatisation et suivi des campagnes

Les APIs marketing permettent de gérer les listes, emails, workflows et événements. Elles sont essentielles pour automatiser vos campagnes et mesurer leur impact.

GET https://api.hubapi.com/marketing-emails/v1/emails
Authorization: Bearer YOUR_ACCESS_TOKEN
        

Cet appel renvoie la liste de vos emails marketing actifs dans HubSpot. Vous pouvez ensuite déclencher un envoi, récupérer les taux d’ouverture et de clics, ou connecter HubSpot à vos propres systèmes d’envoi via API.

3️⃣ API Automation – workflows et actions programmées

HubSpot permet d’automatiser de nombreuses actions : envoi d’emails, création de tâches, notifications internes, ou mise à jour d’un champ CRM. Grâce à l’API Workflow, vous pouvez déclencher, arrêter ou surveiller un workflow depuis vos systèmes externes.

POST https://api.hubapi.com/automation/v3/workflows/{workflowId}/enrollments/contacts/{email}
Authorization: Bearer YOUR_ACCESS_TOKEN
        

Cet appel inscrit un contact identifié par son email dans un workflow existant. Pratique pour lancer un nurturing dès qu’un prospect effectue une action sur votre site ou votre ERP.

4️⃣ Webhooks – la donnée en temps réel

Les Webhooks HubSpot permettent à votre application d’être notifiée en temps réel lorsqu’un événement survient : création de contact, mise à jour d’un deal, changement de propriété, etc. C’est un mécanisme clé pour synchroniser HubSpot avec vos autres systèmes sans polling constant.

{
  "objectType": "contacts",
  "eventType": "contact.creation",
  "objectId": 12345,
  "propertyName": "email",
  "propertyValue": "client@example.com",
  "occurredAt": "2025-10-23T09:12:00.000Z"
}
        

Les notifications Webhooks peuvent être consommées par un endpoint de votre choix (ex. middleware, ETL, API Gateway) et sont sécurisées via signatures HMAC. C’est le meilleur moyen d’assurer la cohérence temps réel de vos données HubSpot ↔ systèmes internes.

3. Authentification et sécurité : API Keys, OAuth 2.0 et scopes HubSpot

L’accès aux APIs HubSpot est protégé par plusieurs mécanismes d’authentification sécurisée. Depuis 2022, HubSpot a déprécié les anciennes API Keys au profit des tokens OAuth 2.0 ou des Private App Tokens, plus robustes et conformes aux standards de sécurité modernes. Chaque méthode s’adapte à un besoin spécifique : intégration interne, application connectée ou synchronisation entre systèmes.

1️⃣ Private App Token : la méthode la plus simple pour vos intégrations internes

Pour une intégration directe entre vos serveurs et HubSpot (sans interaction utilisateur), la méthode recommandée est l’utilisation d’un Private App Token. Ce token, généré depuis votre compte HubSpot, offre un accès sécurisé à vos endpoints choisis.

GET https://api.hubapi.com/crm/v3/objects/contacts
Authorization: Bearer YOUR_PRIVATE_APP_TOKEN
        

Les Private Apps permettent de définir des scopes (permissions précises) comme la lecture ou l’écriture sur les contacts, deals ou tickets. Exemple : crm.objects.contacts.read autorise uniquement la lecture des contacts.

2️⃣ OAuth 2.0 : pour les applications tierces ou multi-utilisateurs

Si vous développez une application connectée à plusieurs comptes HubSpot, utilisez OAuth 2.0. Ce protocole permet à un utilisateur de donner l’accès à votre app sans partager ses identifiants HubSpot. Vous récupérez un access token temporaire et un refresh token pour régénérer l’accès.

GET https://app.hubspot.com/oauth/authorize
?client_id=YOUR_CLIENT_ID
&redirect_uri=https://yourapp.com/oauth/callback
&scope=crm.objects.contacts.read%20crm.objects.contacts.write
        

Après validation par l’utilisateur, HubSpot redirige vers votre redirect_uri avec un code temporaire. Vous échangez ensuite ce code contre un access token :

POST https://api.hubapi.com/oauth/v1/token
Content-Type: application/x-www-form-urlencoded

grant_type=authorization_code
&client_id=YOUR_CLIENT_ID
&client_secret=YOUR_CLIENT_SECRET
&redirect_uri=https://yourapp.com/oauth/callback
&code=YOUR_AUTH_CODE
        

En réponse, HubSpot renvoie un JSON contenant votre access_token et refresh_token. Le token d’accès expire généralement après 6 heures, mais vous pouvez en générer un nouveau via le refresh token.

{
  "access_token": "eyJhbGciOiJIUzI1...",
  "refresh_token": "dbx9f8v3hGJYx9...",
  "expires_in": 21600,
  "scope": "crm.objects.contacts.read crm.objects.contacts.write"
}
                

3️⃣ Sécurité et conformité des appels API

HubSpot impose des bonnes pratiques de sécurité pour protéger les données CRM : authentification forte, chiffrement HTTPS et respect du principe du moindre privilège.

• Tous les appels doivent être effectués via HTTPS (TLS 1.2 minimum).
• Les tokens doivent être stockés côté serveur, jamais dans le front-end.
• Mettre en place une rotation régulière des jetons (rotation key policy).
• Auditer et journaliser les appels sensibles (création, suppression, mise à jour).
• Limiter les IP autorisées si vos intégrations passent par un serveur fixe.

4. Modèle de données HubSpot : contacts, entreprises, deals et propriétés personnalisées

HubSpot repose sur un modèle de données structuré autour d’objets principaux : contacts, entreprises, deals et tickets. Ces objets représentent la base du CRM et sont interconnectés entre eux via des associations. Chaque objet est défini par un ensemble de propriétés (standards ou personnalisées) que vous pouvez manipuler via les APIs HubSpot.

1️⃣ Contacts : le cœur du CRM

L’objet contact représente une personne (lead, prospect, client). Vous pouvez créer, lire, modifier ou supprimer un contact via l’API CRM HubSpot, et gérer des centaines de propriétés comme email, firstname, lifecyclestage, ou des champs personnalisés.

GET https://api.hubapi.com/crm/v3/objects/contacts?limit=5
Authorization: Bearer YOUR_ACCESS_TOKEN
        

Exemple de création d’un contact avec des propriétés standard et personnalisées :

POST https://api.hubapi.com/crm/v3/objects/contacts
Authorization: Bearer YOUR_ACCESS_TOKEN
Content-Type: application/json

{
  "properties": {
    "email": "pauline.martin@example.com",
    "firstname": "Pauline",
    "lastname": "Martin",
    "phone": "+33612345678",
    "lifecyclestage": "customer",
    "segment_persona__c": "Premium"
  }
}
        

Ici, segment_persona__c illustre une propriété personnalisée définie dans votre compte HubSpot. Les propriétés custom permettent d’adapter le modèle de données à vos besoins métiers : scoring, segmentation, ou gestion produit.

2️⃣ Entreprises : vos comptes clients

L’objet entreprise regroupe toutes les informations liées à une organisation (nom, secteur, domaine, taille, chiffre d’affaires...). Chaque entreprise peut être associée à plusieurs contacts ou deals.

POST https://api.hubapi.com/crm/v3/objects/companies
Authorization: Bearer YOUR_ACCESS_TOKEN
Content-Type: application/json

{
  "properties": {
    "name": "Acme Corp",
    "domain": "acme-corp.com",
    "industry": "Technology",
    "numberofemployees": "250",
    "annualrevenue": "1200000"
  }
}
        

Les entreprises peuvent être liées à des contacts via les associations HubSpot. Cela permet, par exemple, d’associer automatiquement un contact à son entreprise selon le domaine de son email.

PUT https://api.hubapi.com/crm/v3/associations/contacts/companies/batch/create
Authorization: Bearer YOUR_ACCESS_TOKEN
Content-Type: application/json

{
  "inputs": [
    {
      "from": { "id": "CONTACT_ID" },
      "to": { "id": "COMPANY_ID" },
      "type": "contact_to_company"
    }
  ]
}
        

3️⃣ Deals : les opportunités commerciales

Les deals représentent les opportunités dans votre pipeline commercial. Chaque deal est associé à un ou plusieurs contacts et à une entreprise. Les propriétés principales incluent dealname, amount, pipeline et dealstage.

POST https://api.hubapi.com/crm/v3/objects/deals
Authorization: Bearer YOUR_ACCESS_TOKEN
Content-Type: application/json

{
  "properties": {
    "dealname": "Refonte site e-commerce",
    "amount": "15000",
    "pipeline": "default",
    "dealstage": "presentationscheduled",
    "closedate": "2025-11-15T00:00:00Z"
  }
}
        

Vous pouvez ensuite relier ce deal à un contact ou une entreprise grâce aux associations API, garantissant une traçabilité complète du cycle de vente.

4️⃣ Propriétés personnalisées : adaptez HubSpot à votre métier

HubSpot permet de créer des propriétés personnalisées sur tous les objets (contacts, entreprises, deals...). Ces propriétés peuvent être ajoutées, mises à jour ou supprimées via API. Elles sont idéales pour stocker des informations spécifiques à votre business (ex. segment client, type de contrat, produit favori...).

POST https://api.hubapi.com/crm/v3/properties/contacts
Authorization: Bearer YOUR_ACCESS_TOKEN
Content-Type: application/json

{
  "name": "segment_persona__c",
  "label": "Segment client",
  "type": "string",
  "fieldType": "select",
  "groupName": "contactinformation",
  "options": [
    { "label": "Standard", "value": "standard" },
    { "label": "Premium", "value": "premium" },
    { "label": "Entreprise", "value": "enterprise" }
  ]
}
        

Ces champs personnalisés enrichissent votre modèle de données HubSpot, facilitant la segmentation, le reporting et les automatisations. Une bonne gouvernance des propriétés (nommage, typage, documentation) garantit la qualité et la cohérence de vos données CRM.

5. Connecter HubSpot à vos outils externes (ERP, e-commerce, support, BI)

L’un des principaux atouts d’HubSpot réside dans sa capacité à se connecter facilement à votre écosystème applicatif. Grâce à ses APIs ouvertes et bien documentées, HubSpot peut dialoguer avec vos outils ERP, e-commerce, support client ou BI afin de centraliser la donnée client et automatiser vos processus.

1️⃣ Connecter un ERP (Odoo, SAP, Sage...)

Relier votre ERP à HubSpot via API permet de synchroniser automatiquement les informations clients, commandes ou factures. Cette connexion élimine les doubles saisies et assure une cohérence entre les données commerciales et financières.

POST https://api.hubapi.com/crm/v3/objects/companies
Authorization: Bearer YOUR_ACCESS_TOKEN
Content-Type: application/json

{
  "properties": {
    "name": "Groupe Lenoir",
    "domain": "groupe-lenoir.fr",
    "customer_code": "ERP-2458",
    "payment_status": "À jour"
  }
}
        

Dans cet exemple, le code client et le statut de paiement issus de l’ERP sont automatiquement envoyés dans HubSpot. Vous pouvez ensuite déclencher des workflows marketing ou commerciaux basés sur ces données synchronisées.

2️⃣ Intégration e-commerce (Shopify, Magento, Prestashop...)

En connectant HubSpot à votre site e-commerce, vous unifiez le parcours client, du premier clic jusqu’à l’achat. Les commandes, abandons de panier et comportements d’achat peuvent être synchronisés dans HubSpot pour alimenter vos campagnes marketing.

POST https://api.hubapi.com/crm/v3/objects/deals
Authorization: Bearer YOUR_ACCESS_TOKEN
Content-Type: application/json

{
  "properties": {
    "dealname": "Commande #5248 - Shopify",
    "amount": "89.90",
    "pipeline": "ecommerce",
    "dealstage": "closedwon",
    "source": "Shopify"
  }
}
        

Cet appel crée automatiquement une opportunité (deal) dans HubSpot dès qu’une commande est passée sur votre boutique Shopify. Les données produits, montants et clients peuvent être enrichies via les endpoints /line_items et /associations.

3️⃣ Support client et helpdesk (Zendesk, Freshdesk...)

Intégrer vos outils de support avec HubSpot permet d’afficher dans chaque fiche contact les tickets ouverts, les échanges SAV ou la satisfaction client. Ainsi, vos équipes commerciales disposent d’un contexte complet avant chaque relance.

POST https://api.hubapi.com/crm/v3/objects/tickets
Authorization: Bearer YOUR_ACCESS_TOKEN
Content-Type: application/json

{
  "properties": {
    "subject": "Problème de facturation",
    "content": "Le client n’a pas reçu la facture de septembre.",
    "hs_pipeline": "0",
    "hs_pipeline_stage": "1",
    "source": "Zendesk"
  }
}
        

Grâce à cette synchronisation, HubSpot devient le centre de pilotage unique de la relation client, combinant la vue marketing, commerciale et support.

4️⃣ Business Intelligence (Power BI, Looker, Tableau...)

Les APIs HubSpot permettent également d’extraire vos données CRM vers un outil de reporting externe pour analyser la performance marketing et commerciale. Il est possible d’automatiser ces extractions via ETL (Airbyte, Fivetran, n8n...).

GET https://api.hubapi.com/crm/v3/objects/deals?properties=dealname,amount,dealstage,closedate
Authorization: Bearer YOUR_ACCESS_TOKEN
        

Cet endpoint récupère les informations essentielles de vos opportunités HubSpot. Vous pouvez ensuite injecter ces données dans Power BI pour visualiser les revenus par segment, les taux de conversion par canal ou la durée moyenne de cycle de vente.

6. Automatiser les workflows HubSpot via API : exemples pratiques et code

Les workflows HubSpot sont au cœur de l’automatisation marketing et commerciale. Ils permettent de déclencher des actions sans intervention humaine : envoi d’emails, création de tâches, notifications internes, mise à jour de propriétés ou déclenchement de webhooks. Via les APIs HubSpot, vous pouvez piloter, déclencher et surveiller vos workflows dynamiquement depuis n’importe quelle application externe.

1️⃣ Piloter un workflow existant

L’API Automation vous permet d’inscrire un contact, une entreprise ou un deal dans un workflow déjà configuré dans HubSpot. C’est idéal pour déclencher des séquences marketing ou commerciales depuis une action externe (achat, formulaire, événement...).

POST https://api.hubapi.com/automation/v3/workflows/{workflowId}/enrollments/contacts/{email}
Authorization: Bearer YOUR_ACCESS_TOKEN
        

Exemple : un client s’inscrit à une démonstration sur votre site. Vous pouvez immédiatement l’ajouter à un workflow de nurturing pour recevoir une série d’emails personnalisés sans attendre une synchronisation manuelle.

2️⃣ Créer un workflow automatiquement via API

Vous pouvez aussi générer de nouveaux workflows par API, par exemple pour des scénarios spécifiques ou des intégrations avancées. Cela vous permet de paramétrer des automatisations à grande échelle depuis vos outils internes.

POST https://api.hubapi.com/automation/v4/workflows
Authorization: Bearer YOUR_ACCESS_TOKEN
Content-Type: application/json

{
  "name": "Relance devis non signé",
  "enabled": true,
  "type": "DRIP_DELAY",
  "actions": [
    {
      "type": "SEND_EMAIL",
      "parameters": { "emailId": "126489" }
    },
    {
      "type": "DELAY",
      "parameters": { "delayMillis": 86400000 }
    },
    {
      "type": "SEND_EMAIL",
      "parameters": { "emailId": "126490" }
    }
  ]
}
        

Ce workflow automatisé envoie un premier email de relance, attend 24 heures, puis en envoie un second si le devis n’a pas été signé. L’automatisation devient ainsi un moteur d’efficacité commerciale au sein de votre CRM.

3️⃣ Déclencher un webhook depuis un workflow

HubSpot permet d’appeler un webhook externe depuis un workflow, pratique pour synchroniser des actions dans d’autres systèmes (ERP, Slack, facturation, SMS, etc.). Vous pouvez également créer ce lien par API pour automatiser la communication entre HubSpot et vos services tiers.

POST https://api.hubapi.com/automation/v4/workflows/{workflowId}/actions
Authorization: Bearer YOUR_ACCESS_TOKEN
Content-Type: application/json

{
  "type": "POST_WEBHOOK",
  "parameters": {
    "url": "https://api.votre-erp.com/hooks/devis-update",
    "method": "POST",
    "headers": {
      "Authorization": "Bearer INTERNAL_TOKEN"
    }
  }
}
        

Ce webhook se déclenche automatiquement à une étape du workflow et transmet les données à votre ERP. Une façon simple de créer une orchestration inter-systèmes sans middleware lourd.

4️⃣ Suivre et auditer vos workflows

L’API HubSpot vous donne accès à des endpoints pour analyser l’exécution des workflows, suivre les contacts inscrits et détecter les erreurs éventuelles. Ces données sont très utiles pour le monitoring et le pilotage des campagnes automatisées.

GET https://api.hubapi.com/automation/v3/workflows/{workflowId}/enrollments/contacts
Authorization: Bearer YOUR_ACCESS_TOKEN
        

Cette requête retourne la liste des contacts actuellement inscrits dans un workflow donné. Vous pouvez exploiter ces données pour vérifier la bonne exécution de vos scénarios et ajuster vos triggers.

7. Synchroniser HubSpot avec votre CRM ou Data Hub existant

De nombreuses entreprises utilisent déjà un CRM historique (Salesforce, Zoho, Pipedrive, Dynamics…) ou un Data Hub centralisé pour agréger leurs données. L’objectif d’une intégration HubSpot n’est donc pas toujours de remplacer l’existant, mais de synchroniser les deux environnements pour fluidifier les échanges et garantir la cohérence de l’information client à chaque étape du parcours.

1️⃣ Pourquoi synchroniser HubSpot avec un autre CRM ?

La synchronisation permet d’assurer que toutes les équipes — marketing, vente et support — disposent d’une même vision de la donnée client. Cela évite les doublons, les pertes d’informations et améliore la réactivité commerciale. Les APIs HubSpot facilitent cette interconnexion en offrant un accès bidirectionnel aux objets du CRM (contacts, entreprises, deals, tickets…).

2️⃣ Exemple : synchronisation HubSpot ↔ Salesforce

HubSpot propose une API native de synchronisation Salesforce, mais Dawap développe souvent des connecteurs personnalisés pour un contrôle complet sur les données synchronisées et les performances. Voici un exemple simple d’envoi d’un contact HubSpot vers Salesforce.

GET https://api.hubapi.com/crm/v3/objects/contacts?properties=email,firstname,lastname,company
Authorization: Bearer YOUR_ACCESS_TOKEN
        

Les données récupérées peuvent ensuite être envoyées dans Salesforce via un POST API personnalisé :

POST https://api.salesforce.com/v1/contacts
Authorization: Bearer SALESFORCE_ACCESS_TOKEN
Content-Type: application/json

{
  "Email": "client@example.com",
  "FirstName": "Thomas",
  "LastName": "Durand",
  "Company": "TechFlow",
  "Source": "HubSpot"
}
        

Cette approche “point à point” fonctionne parfaitement pour de petites volumétries, mais Dawap recommande souvent de passer par un middleware (Airbyte, MuleSoft, n8n, Make, ou un ETL maison) pour gérer les flux volumineux et les erreurs de synchronisation.

3️⃣ Connecter HubSpot à un Data Hub ou un Data Lake

Pour les entreprises disposant d’un Data Hub (Snowflake, BigQuery, Redshift, Azure Synapse…), HubSpot devient une source de données à haute valeur ajoutée. L’extraction des objets CRM via API permet d’alimenter vos entrepôts et tableaux de bord décisionnels en temps réel.

GET https://api.hubapi.com/crm/v3/objects/deals?properties=dealname,amount,dealstage,closedate,hubspot_owner_id
Authorization: Bearer YOUR_ACCESS_TOKEN
        

Les données sont ensuite injectées dans votre Data Hub pour être croisées avec vos données ERP, support ou marketing. Cela permet d’obtenir une vue analytique consolidée du client et de suivre la performance globale du cycle de vente.

4️⃣ Gestion des conflits et gouvernance des données

Lorsqu’on synchronise deux systèmes CRM, la gouvernance de la donnée devient essentielle. Il faut définir des règles claires : quelle source est prioritaire, comment gérer les mises à jour simultanées, et comment tracer les modifications.

• Utiliser un champ last_modified_date pour déterminer la donnée la plus récente.
• Implémenter un identifiant unique commun (ex. external_id).
• Journaliser les échanges pour détecter rapidement les erreurs de synchronisation.
• Mettre en place des alertes en cas d’échec de requêtes API.

8. Exploiter les Webhooks HubSpot pour la donnée en temps réel

Les Webhooks HubSpot permettent de recevoir automatiquement des notifications dès qu’un événement survient dans le CRM : création d’un contact, mise à jour d’une opportunité, fermeture d’un deal, soumission d’un formulaire, etc. Cette approche “event-driven” rend possible une synchronisation temps réel entre HubSpot et vos outils externes (ERP, support client, plateforme marketing, entrepôt de données...).

1️⃣ Principe de fonctionnement

Plutôt que d’interroger l’API HubSpot toutes les minutes pour détecter un changement, vous abonnez votre application à un événement. Dès qu’il se produit, HubSpot envoie automatiquement une requête HTTP (POST) vers votre endpoint public. Cela réduit la charge serveur et garantit une réactivité immédiate.

POST https://api.hubapi.com/webhooks/v3/{appId}/subscriptions
Authorization: Bearer YOUR_ACCESS_TOKEN
Content-Type: application/json

{
  "subscriptionDetails": {
    "eventType": "contact.creation",
    "propertyName": "email"
  },
  "enabled": true,
  "webhookUrl": "https://api.votre-app.com/hooks/hubspot/contact-created"
}
        

Ici, dès qu’un contact est créé dans HubSpot, une requête POST est envoyée à l’URL définie. Votre service peut alors traiter l’événement (enregistrer le contact, déclencher un workflow, créer un client dans l’ERP…).

2️⃣ Exemple de payload reçu

HubSpot envoie les données sous forme de JSON contenant les informations clés de l’événement :

{
  "subscriptionId": 10234,
  "portalId": 123456,
  "occurredAt": 1734925852350,
  "subscriptionType": "contact.creation",
  "objectId": 987654,
  "changeSource": "CRM",
  "propertyName": "email",
  "propertyValue": "client@example.com"
}
        

Vous pouvez ensuite enrichir cet événement en interrogeant l’API HubSpot pour récupérer les propriétés complètes du contact et les intégrer à vos systèmes métiers.

3️⃣ Vérifier la signature de sécurité

Pour des raisons de sécurité, HubSpot signe chaque webhook avec un hash SHA-256 contenu dans l’en-tête X-HubSpot-Signature. Vous devez vérifier cette signature côté serveur pour garantir l’authenticité du message.

# Exemple en Node.js
import crypto from "crypto";

const isValidSignature = (req, secret) => {
  const signature = req.headers["x-hubspot-signature"];
  const computed = crypto
    .createHmac("sha256", secret)
    .update(req.body)
    .digest("hex");
  return signature === computed;
};
        

Ce mécanisme protège votre endpoint contre les requêtes frauduleuses ou injectées. Pensez à renouveler régulièrement votre clé secrète pour renforcer la sécurité.

4️⃣ Bonnes pratiques d’implémentation

• Endpoint public HTTPS obligatoire (certificat TLS valide).
• Réponse 2xx rapide (HubSpot considère tout délai >5s comme un échec).
• Retry automatique : HubSpot relance 10 fois en cas d’échec, avec backoff exponentiel.
• Idempotence : votre traitement doit gérer les doublons d’événements.
• Journalisation : loguer chaque événement reçu pour déboguer et auditer.

5️⃣ Scénarios d’usage concrets

6️⃣ Superviser vos webhooks

HubSpot fournit un tableau de bord et une API de monitoring pour suivre le statut de vos webhooks : nombre d’appels réussis, échecs, temps moyen de réponse, etc.

GET https://api.hubapi.com/webhooks/v3/{appId}/settings
Authorization: Bearer YOUR_ACCESS_TOKEN
        

Vous pouvez ainsi identifier rapidement les endpoints défaillants, détecter les latences et maintenir une intégration robuste et temps réel dans la durée.

9. Bonnes pratiques techniques : quotas, pagination, versioning et erreurs API

Les intégrations HubSpot peuvent rapidement atteindre des volumes importants : synchronisation de milliers de contacts, mise à jour quotidienne de deals ou extraction de données pour le reporting. Pour garantir la fiabilité et la performance de votre connecteur, il est essentiel d’appliquer des bonnes pratiques techniques : gestion des quotas, pagination, versioning et traitement des erreurs.

1️⃣ Respecter les quotas API HubSpot

HubSpot limite le nombre d’appels API par période de temps afin de préserver la stabilité de sa plateforme. En dépassant ces quotas, vos requêtes seront rejetées temporairement avec une erreur HTTP 429 Too Many Requests. Anticiper ces seuils est donc indispensable.

GET https://api.hubapi.com/crm/v3/objects/contacts
Authorization: Bearer YOUR_ACCESS_TOKEN
HTTP/1.1 429 Too Many Requests
Retry-After: 10
        

2️⃣ Gérer la pagination pour les gros volumes

HubSpot renvoie les résultats en lots (par défaut 100 enregistrements par page). Pour parcourir l’ensemble des données, vous devez utiliser le curseur after retourné par l’API.

GET https://api.hubapi.com/crm/v3/objects/contacts?limit=100
Authorization: Bearer YOUR_ACCESS_TOKEN

# Réponse
{
  "results": [...],
  "paging": {
    "next": { "after": "NTYzNzE=" }
  }
}
        

Pour récupérer la suite des données, vous devez rappeler l’API avec le paramètre after reçu. Cette logique évite les surcharges réseau et garantit la stabilité des exports massifs.

GET https://api.hubapi.com/crm/v3/objects/contacts?limit=100&after=NTYzNzE=
Authorization: Bearer YOUR_ACCESS_TOKEN
        

3️⃣ Anticiper le versioning des APIs HubSpot

HubSpot fait évoluer ses APIs régulièrement (v1 → v3). Pour éviter toute rupture de compatibilité, spécifiez toujours la version dans l’URL et surveillez les annonces de dépréciation dans la documentation développeur HubSpot.

GET https://api.hubapi.com/crm/v3/objects/deals
Authorization: Bearer YOUR_ACCESS_TOKEN
        

• Ne mélangez jamais plusieurs versions d’API dans un même flux d’intégration.
• Utilisez des variables d’environnement (HUBSPOT_API_VERSION) pour faciliter les mises à jour.
• Documentez toutes les dépendances API dans votre code source (README, Swagger...).
• Surveillez les changements de schémas dans vos pipelines ETL.

4️⃣ Gérer les erreurs et la résilience des intégrations

Les erreurs API font partie intégrante de tout système distribué. HubSpot renvoie des statuts HTTP explicites qu’il faut savoir interpréter pour réagir intelligemment.

{
  "status": "error",
  "message": "Invalid input JSON on line 1, column 10",
  "correlationId": "2b5e4c72-5ab3-49e2-84e5-2c9cf67823f7",
  "category": "VALIDATION_ERROR"
}
        

5️⃣ Centraliser la documentation technique

Une intégration HubSpot doit être documentée et versionnée au même titre qu’un projet applicatif. Cela facilite la maintenance, les audits de sécurité et le transfert de connaissances entre équipes.

• Utilisez un format standardisé (OpenAPI/Swagger) pour décrire vos endpoints internes.
• Ajoutez des exemples d’appels API et des cas d’erreur courants.
• Centralisez la documentation dans votre outil de gestion de code (GitHub, GitLab, Notion...).

10. Monitoring et logs : superviser vos intégrations HubSpot

Une intégration HubSpot bien conçue ne se limite pas à des appels API fonctionnels : elle doit aussi être monitorée, auditée et supervisée en continu. Le monitoring et la gestion des logs permettent de garantir la fiabilité, la performance et la conformité de vos flux de données. C’est une étape essentielle pour toute entreprise qui fait de HubSpot un point central de son écosystème digital.

1️⃣ Pourquoi superviser vos intégrations HubSpot ?

Les intégrations HubSpot reposent sur des échanges réguliers entre systèmes (CRM, ERP, e-commerce, BI...). Un simple ralentissement ou une erreur non détectée peut avoir un impact sur vos campagnes marketing ou votre force de vente. La mise en place d’un monitoring préventif permet de anticiper les anomalies et de réduire drastiquement le temps de résolution des incidents.

2️⃣ Outils et méthodes de supervision

Le monitoring peut être mis en place à plusieurs niveaux : au sein de vos scripts d’intégration, via un middleware (Make, n8n, Airbyte…) ou à travers une plateforme d’observabilité centralisée (Datadog, Grafana, New Relic…).

# Exemple de log structuré JSON pour le suivi d’un appel API HubSpot
{
  "timestamp": "2025-10-23T14:02:18.481Z",
  "service": "hubspot-sync",
  "endpoint": "https://api.hubapi.com/crm/v3/objects/contacts",
  "method": "GET",
  "status": 200,
  "duration_ms": 342,
  "records_synced": 100,
  "correlationId": "b8a56a2f-7a22-445e-bf3d-43b19b92ea62"
}
        

Ces logs peuvent être envoyés dans une solution comme ELK (Elasticsearch, Logstash, Kibana) ou Datadog pour être visualisés en temps réel sous forme de dashboards. Vous pouvez y suivre vos volumes, vos erreurs et vos temps de réponse.

3️⃣ Alerting et notifications intelligentes

L’intégration d’un système d’alerting permet d’être notifié en cas de défaillance critique ou de pic d’erreurs. Vous pouvez configurer des alertes via email, Slack, Microsoft Teams ou webhook selon votre stack technique.

POST https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX
Content-Type: application/json

{
  "text": ":warning: Échec de synchronisation HubSpot → ERP",
  "attachments": [
    {
      "color": "#ffcc00",
      "fields": [
        { "title": "Status", "value": "HTTP 500", "short": true },
        { "title": "Flux", "value": "Contact Sync", "short": true }
      ]
    }
  ]
}
        

Ces alertes peuvent être enrichies avec le correlationId ou les IDs d’objets pour un diagnostic rapide. Dawap intègre ce type d’alerting dans ses connecteurs afin d’offrir une réactivité instantanée en cas d’anomalie.

4️⃣ Traçabilité et audit des opérations

Chaque interaction entre HubSpot et vos systèmes doit pouvoir être retracée. Les logs permettent de prouver la conformité des traitements, notamment dans le cadre du RGPD (accès, modification ou suppression de données personnelles).

• Conservez l’historique des appels (succès et échecs).
• Associez chaque log à un identifiant d’objet HubSpot (contactId, dealId...).
• Archivez vos logs dans un stockage sécurisé (S3, Azure Blob, GCS...).
• Chiffrez les fichiers de logs contenant des données sensibles.

5️⃣ Intégration du monitoring dans vos process DevOps

Pour garantir la continuité de vos flux, le monitoring doit faire partie de votre pipeline DevOps. Les tests automatiques, les métriques de performance et les alertes font partie d’une culture de supervision proactive.

# Exemple de métrique Prometheus
hubspot_sync_duration_seconds{endpoint="/crm/v3/objects/contacts"} 0.356
hubspot_sync_errors_total{status="429"} 2
hubspot_sync_records_total 14500
        

Ces métriques peuvent être affichées dans Grafana ou Datadog pour suivre les performances de vos intégrations en temps réel.

11. Sécurité, conformité et RGPD dans vos intégrations HubSpot

Les intégrations HubSpot manipulent des données sensibles : informations personnelles, historiques clients, opportunités commerciales. Garantir leur sécurité et leur conformité au RGPD est donc un impératif absolu. Dawap conçoit ses intégrations selon une approche “Security by Design” et “Privacy by Design” pour assurer un niveau de protection maximal à chaque étape du cycle de vie des données.

1️⃣ Authentification et stockage sécurisé des tokens

Les clés d’accès HubSpot (Private App Tokens ou OAuth 2.0) donnent un accès complet à votre CRM. Elles doivent être stockées et gérées de manière sécurisée, hors du code source, dans un coffre-fort ou un secret manager.

# Exemple : stockage d’un token dans un secret manager AWS
aws secretsmanager create-secret \
  --name HubSpotAccessToken \
  --secret-string "eyJhbGciOiJIUzI1NiIs..."
        

✅ Bonnes pratiques :

• Ne jamais stocker un token HubSpot dans le code source, un fichier partagé ou un repository Git.
• Restreindre les scopes d’accès au strict nécessaire.
• Mettre en place une rotation automatique des tokens (tous les 90 jours idéalement).
• Surveiller les connexions actives depuis votre compte HubSpot administrateur.

2️⃣ Chiffrement et transit sécurisé des données

Toutes les communications entre HubSpot et vos systèmes doivent être chiffrées en TLS 1.2 minimum. Les données sensibles (emails, identifiants, champs personnalisés) doivent être chiffrées également côté stockage.

# Exemple d’appel API sécurisé
curl -X POST "https://api.hubapi.com/crm/v3/objects/contacts" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  --tlsv1.2 \
  -d '{"properties": {"email": "client@example.com"}}'
        

3️⃣ Conformité RGPD et gestion du consentement

Le Règlement Général sur la Protection des Données (RGPD) impose des obligations strictes concernant la collecte, le stockage et l’exploitation des données personnelles. Les intégrations HubSpot doivent donc être conçues pour respecter le consentement et la finalité du traitement.

• Assurez-vous que chaque contact importé dans HubSpot ait donné son consentement explicite.
• Transmettez et conservez la preuve du consentement dans un champ dédié (gdpr_consent_status).
• Implémentez le droit à l’oubli : suppression ou anonymisation automatisée via API.
• Formez vos équipes à la manipulation des données RGPD dans HubSpot.

DELETE https://api.hubapi.com/crm/v3/objects/contacts/{contactId}
Authorization: Bearer YOUR_ACCESS_TOKEN
        

Cette requête permet de supprimer un contact de manière définitive, conformément au droit à l’effacement. Vous pouvez aussi anonymiser les données pour conserver les statistiques sans les informations personnelles.

4️⃣ Gouvernance et audit des accès

Une gouvernance claire des accès et des autorisations est indispensable pour prévenir les fuites de données. HubSpot permet d’auditer les connexions et actions utilisateurs directement depuis l’interface administrateur, mais Dawap recommande d’y ajouter une traçabilité externe via API.

GET https://api.hubapi.com/settings/v3/audit/logs
Authorization: Bearer YOUR_ACCESS_TOKEN
        

Ces logs peuvent être archivés dans un outil de SIEM (Security Information and Event Management) pour détecter les anomalies d’accès et renforcer la conformité interne.

12. KPI & ROI : mesurer la performance d’une intégration HubSpot réussie

Une intégration HubSpot ne se juge pas uniquement à sa réussite technique. Son véritable impact se mesure à travers les KPI (indicateurs de performance) et le ROI (retour sur investissement) qu’elle génère pour vos équipes marketing, commerciales et data. Chez Dawap, nous plaçons la **mesure de la performance au cœur de chaque intégration**, afin de relier la technique aux résultats business.

1️⃣ Les 4 axes de performance d’une intégration HubSpot

2️⃣ Les KPI marketing à suivre dans HubSpot

• Taux de synchronisation des leads entre formulaires, CRM et automation.
• Taux d’ouverture et de clics sur les campagnes automatisées.
• Délai moyen entre la génération du lead et la première action commerciale.
• Taux de conversion MQL → SQL (Marketing Qualified Lead → Sales Qualified Lead).
• Nombre d’erreurs API ou d’événements non synchronisés (indicateur de santé technique).

GET https://api.hubapi.com/analytics/v2/reports/leads
Authorization: Bearer YOUR_ACCESS_TOKEN
        

Cet endpoint vous permet de récupérer les données analytiques relatives à la performance de vos formulaires, campagnes et sources de trafic directement depuis HubSpot.

3️⃣ Les KPI commerciaux et data à mesurer

• Délai moyen de traitement d’un lead entre la création et la première interaction.
• Taux de conversion par étape du pipeline (devis envoyé, contrat signé...).
• Revenus générés via les leads issus d’intégrations API (vs manuels).
• Taux d’erreur de synchronisation entre HubSpot et ERP ou Data Hub.
• Latence moyenne d’un flux de données (création → disponibilité CRM).

GET https://api.hubapi.com/crm/v3/objects/deals?properties=dealstage,amount,closedate
Authorization: Bearer YOUR_ACCESS_TOKEN
        

En connectant HubSpot à un outil BI (Power BI, Looker, Tableau), vous pouvez suivre ces indicateurs dans des tableaux de bord unifiés et calculer le ROI réel de vos campagnes.

4️⃣ Calculer le ROI de votre intégration HubSpot

Pour estimer le retour sur investissement d’une intégration, Dawap applique une approche simple et mesurable :

5️⃣ Visualiser et piloter les performances en continu

Les données HubSpot peuvent être exploitées dans des dashboards personnalisés ou via un outil BI. Vous pouvez y suivre vos objectifs en temps réel, segmenter par canal, et identifier rapidement les opportunités d’amélioration.

GET https://api.hubapi.com/analytics/v2/reports/dashboard
Authorization: Bearer YOUR_ACCESS_TOKEN
        

13. Autres solutions du marché

Selon votre stack, vos volumes et votre cycle de vente, certains CRM offrent des APIs et webhooks particulièrement adaptés à une intégration profonde avec vos outils marketing, e-commerce, ERP et support. L’objectif : sélectionner la bonne brique puis la relier proprement à votre écosystème existant.

Salesforce Sales Cloud

Salesforce est une référence sur les intégrations complexes : REST/GraphQL, Bulk API, Streaming et AppExchange. Convient aux organisations multi-pays avec gouvernance avancée et exigences fortes de scalabilité.

Découvrir notre guide Salesforce

Microsoft Dynamics 365

Dynamics 365 s’intègre nativement au monde Microsoft (Azure, Power Platform, Power BI). APIs robustes, Dataverse et connecteurs pour aligner ventes, service et finance.

Découvrir notre guide Dynamics 365

Zoho CRM

Zoho CRM combine APIs complètes et écosystème applicatif (Books, Desk, Campaigns). Pertinent pour accélérer l’automatisation à coût maîtrisé avec un bon niveau de personnalisation.

Découvrir notre guide Zoho CRM

Pipedrive

Pipedrive séduit par sa simplicité et ses webhooks efficaces (deals, activités). Idéal pour des flux CRM ↔ marketing légers, avec forte adoption côté sales.

Découvrir notre guide Pipedrive

Freshsales (Freshworks)

Freshsales propose une suite cohérente (CRM, support, téléphonie) et des APIs convenant aux organisations cherchant un time-to-value rapide avec téléphonie intégrée.

Découvrir notre guide Freshsales

Zendesk Sell

Zendesk Sell (ex-Base) se connecte naturellement à Zendesk Support. APIs adaptées aux équipes orientées service client et cycle de vente court.

Découvrir notre guide Zendesk Sell

SugarCRM

SugarCRM offre une grande flexibilité on-premise/cloud et un modèle de données extensible. APIs REST matures pour construire des intégrations sur mesure.

Découvrir notre guide SugarCRM

Copper (Google Workspace)

Copper s’imbrique nativement dans Google Workspace (Gmail, Calendar, Drive). APIs pensées pour des workflows commerciaux simples et rapides côté PME.

Découvrir notre guide Copper

monday sales CRM

monday propose un CRM modulable basé sur des boards, avec API GraphQL et automatisations. Utile pour aligner projets, ventes et marketing dans une même plateforme.

Découvrir notre guide monday sales CRM

Odoo CRM

Odoo (suite open-source) facilite l’intégration CRM ↔ ERP ↔ e-commerce. APIs et modules nombreux pour bâtir un SI unifié à coût maîtrisé.

Découvrir notre guide Odoo CRM

SuiteCRM (open-source)

SuiteCRM offre une alternative open-source à personnaliser profondément. APIs REST et écosystème de modules pour des besoins spécifiques ou on-premise.

Découvrir notre guide SuiteCRM

Oracle CX Sales

Oracle CX Sales cible les contextes enterprise avec exigences élevées d’intégration ERP/finance. APIs étendues et sécurité avancée pour environnements régulés.

Découvrir notre guide Oracle CX Sales

SAP Sales Cloud

SAP Sales Cloud s’intègre finement aux suites SAP (S/4HANA, ERP, Analytics). APIs robustes pour aligner ventes complexes et back-office industriel.

Découvrir notre guide SAP Sales Cloud

Insightly

Insightly combine CRM et gestion de projets. APIs adaptées pour relier ventes, exécution et reporting sans multiplier les outils.

Découvrir notre guide Insightly

Close CRM

Close mise sur l’efficacité commerciale (calls, SMS, emails) avec APIs et webhooks orientés productivité sales. Idéal pour inside sales et cycles courts.

Découvrir notre guide Close CRM