Connecter HubSpot à votre logiciel métier

Quelles données HubSpot un logiciel métier peut-il lire et écrire ?

L'API CRM de HubSpot couvre presque tout ce qu'une PME y range. La page de la documentation développeur qui classe les API par niveau d'abonnement place dans l'offre gratuite les contacts, entreprises, transactions (deals), tickets, produits, lignes de produits, devis, factures et commandes, ainsi que l'API d'import et les webhooks.

Sur ce dernier point, la même page fait aussi apparaître les objets personnalisés dans la colonne de l'offre gratuite. Avant de bâtir une intégration autour d'un objet « Machine » ou « Contrat », vérifiez dans votre compte qu'il est réellement disponible.

App privée, authentification statique ou OAuth : quelle porte d'entrée ?

Pour relier un logiciel métier à votre seul compte HubSpot, la voie la plus simple est un jeton propre à une application, envoyé dans l'en-tête Authorization. Deux générations d'applications coexistent en 2026.

• Apps privées héritées : la documentation de HubSpot les range désormais parmi ses applications « legacy ». Une intégration existante qui en utilise une se relit au regard de la page qui leur est consacrée ; un nouveau projet part plutôt sur la nouvelle plateforme.
• Nouvelle plateforme de développement : une app à authentification statique, distribuée en privé, utilise un jeton tiré de ses paramètres pour un compte unique. Pour plusieurs comptes, il faut OAuth 2.0 ; une app OAuth distribuée en privé s'installe dans 10 comptes au plus.
• Applications de la place de marché : uniquement en OAuth, avec un serveur qui lance l'autorisation et gère les jetons des comptes qui installent l'app.

Une PME qui branche son ERP ou son outil de planification n'a besoin que d'une app privée ou statique. OAuth s'impose quand vous éditez un logiciel que vos propres clients relieront à leur HubSpot, cas traité dans notre page sur le développement de SaaS sur mesure.

Comment ménager les limites d'appels de HubSpot ?

HubSpot publie ses plafonds d'appels dans ses règles d'usage de l'API (API usage guidelines and limits). La page qui classe les API par niveau d'abonnement affiche, de l'offre gratuite à Enterprise, la mention « 100 reqs/10 sec » suivie d'un astérisque qui renvoie à ces règles. Avant de dimensionner un flux, relevez donc dans ces règles les valeurs qui s'appliquent à votre abonnement et à votre type d'application, puis comparez-les au volume réel de vos échanges.

Le dernier levier est le plus efficace : selon le guide des webhooks de HubSpot, les requêtes que HubSpot envoie à votre service par webhook ne comptent pas dans les limites d'appels de votre app. Un programme qui interroge le CRM en boucle consomme son quota pour rien ; un service prévenu par webhook n'appelle l'API que lorsqu'un changement a eu lieu.

Comment fonctionnent les webhooks HubSpot ?

Les webhooks HubSpot préviennent votre service quand un contact, une entreprise, une transaction, un ticket, un produit ou une ligne de produit est créé, supprimé, fusionné, restauré, modifié sur une propriété ou, selon l'objet, change d'association.

• Envoi groupé : une requête contient jusqu'à 100 événements.
• Délai de réponse : votre service répond en 5 secondes au plus, sinon l'envoi compte comme échoué.
• Renvois : jusqu'à 10 tentatives sur les 24 heures suivantes, après une coupure, un délai dépassé ou une réponse 4xx ou 5xx.
• Ordre et doublons : l'ordre n'est pas garanti et un événement peut arriver deux fois ; le champ occurredAt permet de les remettre en ordre.
• Signature : l'en-tête X-HubSpot-Signature porte une empreinte SHA-256 calculée avec le secret de l'app.
• Quotas : les envois de webhooks ne comptent pas dans les limites d'appels ; une app accepte 1 000 abonnements au plus.

Les abonnements se règlent dans les paramètres de l'app ou par les points d'accès de l'API des webhooks. Le service de réception enregistre l'événement, répond aussitôt, puis le traite en file d'attente en ignorant ceux déjà vus.

Ce qui circule entre HubSpot et l'ERP : quatre exemples

1. L'affaire gagnée lance la fabrication. Un fabricant de mobilier d'agencement passe une transaction à l'étape « gagnée » ; le webhook de changement de propriété prévient le service d'intégration, qui relit la transaction et ses lignes de produits, puis crée l'ordre de fabrication dans l'ERP avec la référence HubSpot.
2. Le catalogue part de l'ERP. Chaque nuit, les articles créés ou modifiés dans la gestion commerciale sont poussés par lots vers les produits HubSpot : les commerciaux composent leurs devis avec les prix du jour.
3. L'encours remonte sur la fiche entreprise. Le logiciel de facturation calcule l'encours et les retards de paiement, puis met à jour une propriété de l'entreprise : le commercial voit les impayés avant de proposer une nouvelle affaire.
4. La panne devient ticket. Un client déclare un incident depuis son espace en ligne ; un ticket est créé dans HubSpot et associé au contact, puis le technicien qui clôt l'intervention sur son application terrain ferme le ticket.

Pour la reprise initiale de milliers de fiches, l'API d'import convient mieux qu'une boucle d'appels unitaires ; notre guide de la migration des données décrit la méthode.

Pourquoi une intégration HubSpot se revoit deux fois par an

Depuis le 30 mars 2026, les API HubSpot portent une version datée dans leur adresse, par exemple /2026-03/. Une version sort tous les six mois, en mars et en septembre. Elle reste « current » six mois, passe ensuite en « supported » avec les seuls correctifs critiques, et devient « unsupported » 18 mois après sa sortie : elle peut encore répondre, mais HubSpot déconseille de compter sur sa stabilité. Les anciennes API v1 à v4 restent accessibles à leurs adresses historiques.

Concrètement, chaque sortie de mars ou de septembre déclenche une lecture des notes de version, un passage des tests sur un compte de test et, si besoin, une bascule vers la version courante. Ce temps se prévoit dès le départ dans un contrat de maintenance applicative.

Les étapes d'un branchement HubSpot sans casse

1. Fixer la clé de rapprochement : adresse e-mail pour un contact, SIREN rangé dans une propriété personnalisée pour une entreprise. Sans clé unique, chaque outil fabrique ses doublons.
2. Vérifier l'hébergement : selon la base de connaissances HubSpot, l'infrastructure tourne chez AWS aux États-Unis, au Canada, en Australie et dans l'Union européenne (Allemagne). Le centre de données est attribué selon la géolocalisation de l'adresse IP à l'inscription, et un compte Starter, Professional ou Enterprise peut en changer ; l'emplacement se lit dans les paramètres, rubrique Privacy & Consent, onglet Data Hosting.
3. Réduire les données copiées : les contacts sont des données personnelles ; le logiciel métier ne reçoit que les propriétés utiles, et le journal garde des identifiants. Voir notre guide RGPD et logiciel métier.
4. Créer l'app avec des scopes minimaux, jeton rangé dans un coffre de secrets côté serveur.
5. Construire sur un compte de test : HubSpot permet de créer des comptes de test développeur, qui reçoivent par défaut des essais Enterprise de tous les hubs.
6. Ouvrir les flux un par un sur le compte réel, en commençant par quelques fiches contrôlées.

Application de la place de marché ou service sur mesure ?

La place de marché HubSpot distribue des applications d'éditeurs tiers. Si votre ERP ou votre logiciel de facturation y a un connecteur, testez-le d'abord : c'est un développement évité. Le sur-mesure se justifie quand votre logiciel métier est spécifique, quand la règle de rapprochement est riche (une entreprise à plusieurs sites, des contacts partagés entre filiales) ou quand le flux touche à la facturation.

YMHB Web livre alors un service d'intégration installé sur votre compte d'hébergement : file d'attente qui absorbe les rafales de webhooks, journal consultable de chaque échange, alerte quand le taux d'erreurs monte, documentation des correspondances de propriétés. Le code vous est remis au paiement intégral. Pour situer HubSpot face à son concurrent le plus cité, voir HubSpot ou Salesforce ; pour la démarche générale, connecter ses logiciels par API.