Les limites d'usage de l'API HubSpot

Combien d'appels API notre portail supporte-t-il, et que se passe-t-il quand plusieurs intégrations tirent dessus en même temps ?

Deux plafonds coexistent, et la distinction change tout.

Le plafond de rafale est par application privée, à savoir cent appels par dix secondes en gratuit et Starter, cent quatre-vingt-dix en Professionnel et Entreprise.
Le plafond journalier est par compte, à savoir deux cent cinquante mille appels en gratuit et Starter, six cent vingt-cinq mille en Professionnel, un million en Entreprise.

Conséquence directe, et c'est le point que les équipes techniques découvrent tard. Multiplier les intégrations ne desserre pas la contrainte quotidienne, elle partage le même budget.

Au dépassement, HubSpot renvoie une erreur de type quota dépassé sur tous les appels suivants.

Le piège à connaître. Deux pages officielles de HubSpot donnent deux chiffres différents pour la rafale avec extension de limite. Relevez la valeur applicable à votre portail plutôt que de vous fier à un chiffre.

Pourquoi le quota journalier est partagé par tout le portail

Le compteur journalier se remet à zéro à minuit dans le fuseau de votre compte, ce qui compte si vos intégrations tournent depuis un autre pays.

Pour une application publique installée chez un client, le plafond est de cent dix appels par dix secondes par compte connecté, et l'extension payante ne s'y applique pas.

L'extension existe mais elle est bornée. Vous ne pouvez acheter que deux augmentations de limite, chacune apportant un million d'appels journaliers en plus. Et certaines limites, notamment sur l'API des associations, ne peuvent pas être relevées davantage.

Trois plafonds spécifiques à connaître, parce qu'ils cassent les traitements en masse. L'API de recherche est limitée à cinq requêtes par seconde et deux cents fiches par page. Les traitements par lot du CRM sont limités à cent fiches par requête.

Deux exemptions utiles. Les appels de webhook déclenchés par un workflow ne comptent pas dans la limite. Et les requêtes exemptées ne sont pas journalisées, ce qui veut dire qu'elles sont invisibles dans vos diagnostics.

Une divergence dans la documentation, que nous signalons plutôt que de trancher. Deux pages officielles donnent deux chiffres différents pour la rafale avec extension, deux cent cinquante sur l'une, deux cents sur l'autre. Relevez la valeur applicable à votre portail plutôt que de vous fier à un chiffre.

Enfin, un seuil de qualité à connaître si vous visez la certification. Les requêtes en erreur ne doivent pas dépasser cinq pour cent du total quotidien.

En pratique, dimensionner ses intégrations sous le plafond d'API

Où voir votre consommation

Sur la fiche d'une application privée, un onglet expose les appels et les journaux. Attention, ces journaux sont conservés trente jours, et HubSpot ne stocke ni le corps de la requête, ni les paramètres d'URL, ni la charge de réponse des appels réussis.

Les trois réflexes qui évitent le plafond

Passer par les traitements en lot plutôt que par des appels unitaires, dans la limite de cent fiches par requête.
Utiliser les webhooks plutôt que d'interroger en boucle. Attendre un événement coûte zéro appel.
Étaler les traitements de masse, en particulier si plusieurs intégrations partagent le portail.

Le calcul à faire avant de brancher une nouvelle intégration

Additionnez les volumes quotidiens annoncés par chaque intégration existante, et comparez au plafond de votre abonnement. Si vous approchez les soixante-dix pour cent, la nouvelle intégration n'entrera pas sans arbitrage.

Ce qu'il ne faut pas faire

Créer plusieurs applications privées pour contourner le plafond. La rafale se desserre, le quota journalier non.

À surveiller sur les limites d'appels API de HubSpot

La rafale est par application privée, le quota journalier est par compte.
Le compteur se remet à zéro à minuit dans le fuseau du compte.
L'extension est plafonnée à deux achats, et certaines limites ne se relèvent pas.
L'API de recherche est limitée à cinq requêtes par seconde.
Les lots sont limités à cent fiches par requête.
Les webhooks déclenchés par workflow ne comptent pas dans la limite.
Les journaux ne gardent que trente jours, sans le corps des requêtes réussies.
Deux pages officielles se contredisent sur la rafale avec extension.

Quand nous contacter sur les limites d'appels API de HubSpot

Contactez Yuzu Corp avant d'ajouter une intégration sur un portail déjà chargé. Le calcul de charge se fait en amont, et un plafond atteint bloque toutes les intégrations à la fois, pas seulement la dernière.

Pour aller plus loin, découvrez notre offre RevOps.

Auteur, sources et date de vérification

Rédigé par Marin Desgrées du Loû Atias
Sales Ops chez Yuzu Corp · 3 ans sur HubSpot · Nantes & Paris
Yuzu Corp est partenaire HubSpot Diamond et membre du Claude Partner Network
Publié le 2 septembre 2026 · Vérifié sur HubSpot le 1 septembre 2026