Page mise à jour le
Ce que l'API permet
Ce que HubSpot expose réellement
Repris de la documentation publique de l'éditeur, pas d'une plaquette commerciale. Le lien vers cette documentation est en bas de page.
Contacts, entreprises, transactions et tickets
On crée, lit, met à jour et archive les contacts — et les mêmes gestes existent pour les autres objets du CRM. Un contact peut être retrouvé par son identifiant ou par son e-mail. On l'associe à une entreprise ou à une transaction dès la création, pour ne pas laisser des fiches orphelines. Les propriétés standard (e-mail, nom, étape de cycle de vie) cohabitent avec les propriétés que vous avez ajoutées ; encore faut-il en demander la liste, parce qu'une propriété absente de la demande n'est tout simplement pas renvoyée.
Écriture par lots, dans une limite de cent fiches
Créer ou mettre à jour une fiche à la fois convient à un formulaire. Reprendre un export de trois cents lignes demande les appels par lots, plafonnés à cent enregistrements par requête. Au-delà, on découpe. C'est documenté, ce n'est pas un défaut caché. Un import mal découpé se prend un refus, pas un « on verra plus tard ». Pour éviter les doublons, l'e-mail reste l'identifiant recommandé sur le contact.
Écouter un changement plutôt que tout relire
Une application peut s'abonner à des événements (jusqu'à mille abonnements par application) et recevoir les mises à jour sans interroger le CRM en boucle. Les envois depuis HubSpot vers vous ne comptent pas dans le plafond d'appels. En revanche, pousser une fiche depuis un workflow HubSpot vers l'extérieur via une action « webhook » est réservé, d'après les lignes directrices d'usage, aux comptes Marketing Enterprise. Les deux mécanismes n'ont pas le même prérequis : les confondre fait découvrir le forfait trop tard.
Recherche, plus stricte que le reste
Chercher une fiche par un critère (domaine, nom, propriété personnalisée) passe par une recherche dédiée, plus limitée que la lecture simple. Les en-têtes de plafond n'y sont pas renvoyés. Une synchro qui « cherche avant de créer » pour éviter les doublons consomme donc ce canal-là, pas le canal général. On le dimensionne, on ne l'improvise pas sur un fichier de plusieurs milliers de contacts.
Documentation développeur HubSpot — API et plafonds d'usage (nouvel onglet) — Lignes directrices officielles : plafonds par forfait, applications privées, abonnements d'événements. Consultées le 21-08-2026. Objets CRM décrits dans la référence 2026-03.
Trois automatisations concrètes
Ce qu'on met en place avec
Trois situations réelles, décrites comme du travail plutôt que comme de la technique.
Créer la fiche dès le premier échange utile
Un formulaire, un devis accepté, un e-mail qualifié : l'agent cherche le contact par e-mail, le crée s'il n'existe pas, l'associe à l'entreprise, pose l'étape de cycle de vie. Il n'invente pas une entreprise homonyme. Si deux fiches existent déjà, il les signale plutôt que d'en faire une troisième. La qualité du CRM se joue à cette seconde, pas dans un dédoublonnage annuel.
Faire suivre la transaction quand le devis avance
Quand un devis passe à « accepté » dans votre outil commercial, l'agent met à jour le montant et l'étape de la transaction HubSpot, ou la crée. L'inverse aussi : une transaction gagnée ailleurs ne doit pas rester « en cours » ici. Un recul d'étape de cycle de vie n'est pas un simple champ à écraser : HubSpot n'autorise l'étape que vers l'avant, sauf à vider la valeur d'abord. C'est une règle métier déguisée en contrainte technique, et on la respecte.
Remonter un ticket plutôt qu'un fil perdu
Un incident client arrivé par mail ou par la boutique ouvre un ticket, lié au contact. L'agent n'envoie pas de réponse automatique au client : il prépare le dossier et vous laisse le ton. Quand le ticket est clos, le statut suit. Un CRM où les incidents vivent dans la boîte mail de quelqu'un n'est pas un CRM, c'est un espoir.
Limites
Ce que cette intégration ne fera pas
Les contraintes qu'on rencontre pour de vrai. Les découvrir maintenant coûte une lecture ; les découvrir en cours de projet coûte le projet.
Les plafonds d'appels suivent le forfait
Pour une application privée, HubSpot documente 100 appels par 10 secondes et 250 000 par jour sur les comptes Free et Starter ; 190 par 10 secondes et 625 000 par jour en Professional ; 190 et 1 000 000 en Enterprise. Le plafond quotidien est partagé entre toutes les applications du compte. Un dépassement renvoie une erreur 429. Relire tout le fichier chaque nuit sur un petit forfait n'est pas un choix d'architecture, c'est une façon de s'arrêter en milieu de mois.
Certaines actions de workflow sont payantes
Les lignes directrices d'usage indiquent qu'envoyer des données de contact depuis un workflow HubSpot vers un système externe via une action webhook suppose un abonnement Marketing Enterprise. Une application qui s'abonne elle-même aux événements n'a pas ce prérequis, mais elle doit être construite et hébergée. « On coche la case dans le workflow » n'est donc pas universel. On le vérifie sur le compte réel, pas sur une démo.
L'étape de cycle de vie ne recule pas toute seule
On ne peut poser une étape de cycle de vie que vers l'avant. Revenir en arrière exige d'effacer d'abord la valeur. Une synchro naïve qui réécrit « lead » sur un client déjà facturé échoue ou, pire, ne fait rien d'utile. C'est le genre de règle qu'on découvre sur la troisième fiche si on n'a pas lu la page contacts. On la traite comme un invariant, pas comme un cas particulier.
Ce que brancher HubSpot demande vraiment
Une application privée, des droits limités aux objets utiles, un test de plafond sur le forfait réel. Premier flux : création de contact à partir d'une source unique (formulaire ou devis), avec recherche préalable. Ensuite seulement les transactions. On ne commence pas par « tout synchroniser ». HubSpot est déjà un système de vérité pour beaucoup d'équipes ; le travail consiste à le rester, pas à le dupliquer.
Sources
Chaque affirmation de cette page renvoie au texte qui fait foi. En cas d'écart entre cette page et la source, c'est la source qui a raison.
- Référence API contacts HubSpot (2026-03) (nouvel onglet)
Création, lecture, lots de 100, associations, contrainte sur l'étape de cycle de vie.
Vos questions
Le forfait gratuit de HubSpot suffit-il pour une intégration ?
Il permet de lire et d'écrire les fiches, oui. Il plafonne aussi fortement le nombre d'appels : 100 toutes les 10 secondes et 250 000 par jour pour les applications privées, plafond partagé. Une petite équipe qui crée des contacts à l'unité passe. Une reprise d'historique ou une relance de tout le fichier chaque nuit ne passe pas. La question n'est donc pas « est-ce que l'API existe en gratuit », c'est « quel volume réel on va lui demander ». Ce volume se compte avant d'écrire la synchro, pas après le premier 429.
Comment éviter les doublons de contacts ?
En cherchant d'abord par e-mail, qui est l'identifiant unique recommandé par HubSpot, puis en créant seulement si rien n'existe. Un nom homonyme n'est pas un critère. Les e-mails supplémentaires d'une fiche restent des identifiants uniques : deux contacts ne peuvent pas partager la même adresse, même en secondaire. Quand deux fiches existent déjà, on arrête et on vous les montre. Fusionner est un geste humain ; le faire tout seul à partir d'un prénom est une destruction de dossier.
Peut-on tout faire depuis un workflow HubSpot, sans application ?
Certaines actions oui, notamment pousser une fiche vers l'extérieur, et les lignes directrices réservent cette action webhook des workflows au Marketing Enterprise. Le reste — créer une transaction à partir d'un devis dans un autre outil, relire un ticket, associer une entreprise — se fait par une application qui parle à l'API. Confondre les deux, c'est découvrir en cours de route qu'il faut soit monter de forfait, soit construire l'application qu'on croyait éviter. On tranche au cadrage.
Une idée en tête ?
Réservez un rendez-vous ou écrivez-nous — réponse sous 24 h.