Page mise à jour le
Ce que l'API permet
Ce que Pipedrive 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.
Affaires, personnes, organisations, activités
On crée une affaire, on la fait changer d'étape, on la marque gagnée ou perdue. On rattache une personne et une organisation, on pose une activité (appel, rendez-vous, tâche). C'est le vocabulaire du commercial, pas celui du développeur, et l'API le suit. Une affaire sans personne est un pipeline vide de sens. L'API v2, documentée comme plus économe en jetons que la v1, est à privilégier pour les lectures répétées. Les webhooks existent : mieux vaut être prévenu d'un changement que relire le pipeline toutes les minutes.
Un budget quotidien de jetons, pas un simple compteur
Le budget se calcule ainsi : 30 000 jetons de base, multipliés par un coefficient de forfait (1 en Lite, 2 en Growth, 5 en Premium, 7 en Ultimate), multipliés par le nombre de sièges, plus d'éventuels recharges. Une lecture d'une fiche coûte 2 jetons, une liste 20, une mise à jour 10, une recherche 40. Quand le budget est à 75 %, l'administrateur reçoit un mail ; à 100 %, chaque appel suivant est refusé jusqu'au lendemain. C'est public, ce n'est pas une surprise.
Des rafales courtes, en plus du budget
Même avec du budget, on ne peut pas tout envoyer d'un coup. Sur 2 secondes, une clé d'API tient 20 requêtes en Lite, 40 en Growth, 100 en Premium, 120 en Ultimate. Les applications OAuth ont des plafonds plus hauts. La recherche, elle, reste à 10 requêtes / 2 secondes quel que soit le forfait. Une reprise d'historique « le plus vite possible » se prend ces rafales en pleine figure. On espace, on ne force pas.
Clé d'API ou application OAuth
Pour votre propre compte, une clé d'API suffit. Pour un produit installé chez plusieurs clients Pipedrive, OAuth et éventuellement le Marketplace. Les plafonds de rafale ne sont pas les mêmes. Une clé mal configurée qui ignore les 429 peut ensuite recevoir un 403, avec blocage côté infrastructure. Pipedrive le documente : ce n'est pas le sort de la majorité, c'est celui des intégrations qui insistent.
Documentation Pipedrive — démarrage et plafonds (nouvel onglet) — Démarrage officiel. Les plafonds à jetons et les rafales sont détaillés dans core-api-concepts-rate-limiting. Consultée le 21-08-2026.
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.
Ouvrir l'affaire dès le devis envoyé
Un devis part : l'agent cherche l'organisation, crée l'affaire au bon montant, pose l'activité « relancer dans cinq jours ». Il ne crée pas une seconde affaire si une affaire ouverte existe déjà pour le même devis. Le commercial voit le pipeline à jour sans recopie. Si le devis est refusé, l'affaire passe à perdue avec le motif que vous avez choisi — pas « autre » par défaut.
Avancer l'étape quand le client répond
Un e-mail de signature, un bon de commande, un premier paiement : l'agent fait passer l'affaire à l'étape suivante et clôt l'activité en retard. Il ne saute pas trois étapes parce qu'un mot-clé a matché. Les cas ambigus vous reviennent. Un pipeline dont les étapes bougent toutes seules sans règle écrite n'est plus un pipeline, c'est un historique illisible.
Rappeler ce qui n'a pas bougé
Chaque matin, la liste des affaires sans activité à venir depuis X jours est préparée, pas envoyée au client. C'est un ordre du jour pour le commercial. Pipedrive sait lister les activités ; il ne sait pas si « on s'est parlé au téléphone hier ». Une note manuelle reste prioritaire. L'agent relance l'interne, pas le prospect, tant que vous n'avez pas validé le message.
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.
À budget vide, plus rien ne passe jusqu'à minuit
Le reset n'est pas minuit chez vous, c'est minuit sur le serveur Pipedrive. Une synchro mal calée peut donc s'arrêter en milieu d'après-midi et ne reprendre que le lendemain. Des recharges de jetons existent ; les monter de forfait ou de sièges aussi. Aucune de ces options n'est un droit acquis : on les lit dans le tableau de bord d'usage avant de lancer une reprise d'historique. Relire tout le fichier par recherche (40 jetons l'unité) est la façon la plus rapide de se vider.
La recherche est volontairement plus chère et plus lente
Chercher une personne par e-mail coûte 40 jetons et tient 10 requêtes par 2 secondes, tous forfaits confondus. Une boucle « chercher puis créer » sur un import de plusieurs milliers de lignes n'est pas tenable telle quelle. On importe par lots, on mémorise les identifiants, on ne recherche pas deux fois la même adresse. C'est de l'hygiène, pas de l'optimisation gratuite.
Le plafond d'affaires n'est pas infini
Pipedrive documente un maximum absolu de 300 000 leads et affaires par compte, et un plafond de jetons d'API à 100 millions, quels que soient les sièges. Peu de TPE s'en approchent. Celles qui gardent dix ans d'affaires perdues dans le pipeline actif, si. Archiver n'est pas un sujet d'esthétique, c'est ce qui garde l'API vivable.
Ce que brancher Pipedrive demande vraiment
Une clé, un premier flux « devis → affaire », un regard sur le tableau d'usage après 48 h. On n'écoute les webhooks qu'une fois la création d'affaire stable, pour ne pas traiter deux fois le même événement. Le budget de jetons se calcule avec le forfait réel et le nombre de sièges, pas avec une moyenne lue sur un blog. Si le commercial vit dans Pipedrive, on n'y écrit que ce qu'il a décidé de voir bouger tout seul.
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.
- Plafonds à jetons de l'API Pipedrive (nouvel onglet)
Budget quotidien, coûts par type d'appel, rafales par forfait, reset à minuit serveur.
Vos questions
L'API Pipedrive est-elle comprise dans tous les forfaits ?
Oui, l'accès existe sur les forfaits payants documentés (Lite et au-delà), avec un budget de jetons qui monte avec le forfait et les sièges. Ce n'est pas un accès illimité. Un compte Lite à un siège a 30 000 jetons par jour ; un compte Ultimate à plusieurs sièges en a beaucoup plus. La question utile au cadrage n'est pas « est-ce inclus », c'est « combien de lectures et d'écritures par jour, et à quel coût en jetons ». On le calcule avant la reprise d'historique.
Faut-il passer en v2 ?
Pipedrive présente la v2 comme plus économe en jetons pour les mêmes gestes. Pour une intégration nouvelle, c'est le choix raisonnable. Une intégration ancienne en v1 continue de fonctionner tant que l'éditeur la maintient, mais elle vide le budget plus vite. On ne « migre pas pour migrer » : on migre les appels les plus fréquents d'abord, ceux qui tournent toutes les minutes, pas le script annuel d'export.
Que se passe-t-il si on dépasse le budget en cours de journée ?
Les appels sont refusés avec un 429 jusqu'au reset de minuit côté serveur. Les administrateurs ont normalement reçu un mail à 75 % puis à 100 %. Les actions faites à la main dans Pipedrive, elles, ne consomment pas ce budget. L'équipe commerciale n'est donc pas bloquée dans l'écran ; c'est l'automatisation qui s'arrête. On la dimensionne pour finir la journée, ou on ajoute une recharge, ou on réduit les lectures inutiles. Relancer plus vite empire le 429.
Une idée en tête ?
Réservez un rendez-vous ou écrivez-nous — réponse sous 24 h.