Ressources · Intégration n8n

Intégration Pipedrive n8nAutomatiser Pipedrive avec n8n.

Chaque deal, chaque activité et chaque fichier du CRM devient une étape de workflow. L'intégration Pipedrive n8n expose 49 opérations sur 9 ressources, plus un trigger webhook qui surveille 4 types d'événements. Pour les équipes qui tiennent leur pipeline sans le ressaisir.

Avis vérifiés sur Trustpilot · Agence IA, automatisation & growth

Pourquoi automatiser

Que couvre vraiment l'intégration Pipedrive n8n ?

L'intégration Pipedrive n8n, ce sont deux nœuds. Le nœud Pipedrive lit et écrit 9 ressources (activités, deals, produits de deal, fichiers, leads, notes, organisations, personnes et produits) à travers 49 opérations. Le Pipedrive Trigger surveille l'objet sélectionné et se déclenche sur 4 types d'événements : added, updated, merged et deleted. Les deux tournent sur le même credential, la connexion enregistrée une fois dans n8n.

Commence par les deals qui dorment. deal.getAll avec Return All coché remonte tout le pipeline, un filtre garde ceux qui n'ont pas bougé depuis trop longtemps, et activity.create pose une tâche de relance datée sur chacun, assignée au bon commercial. Plus personne ne repasse sur les cartes une par une le vendredi soir.

La signature, ensuite. Le contrat arrive en pièce jointe, file.create l'envoie sur le deal depuis le champ binaire du nœud précédent, deal.update bascule le statut en won avec le montant réel, et dealProduct.add écrit les lignes vendues avec leur prix et leur quantité. La facturation part alors d'un chiffre qui correspond à ce qui a été signé. Même mécanique quand les deals arrivent d'une reprise depuis Salesforce, leurs documents derrière eux.

Le lundi matin, c'est le reporting qui compte. Les deals remontés par la même opération partent dans un export Google Sheets pour la prévision, et un résumé tombe dans Slack avant la réunion commerciale. Les filtres travaillent côté Pipedrive : une étape, un propriétaire, ou un filtre déjà enregistré dans le CRM.

Le nœud s'arrête à 49 opérations sur 9 ressources. Quand un endpoint de l'API Pipedrive sort de cette liste, le nœud HTTP Request l'appelle directement et réutilise le même credential Pipedrive via l'authentification prédéfinie. Rien de plus à stocker, rien de plus à maintenir à côté.

Deux limites méritent d'être connues avant de construire. Les opérations de liste s'arrêtent à Limit tant que Return All n'est pas coché, et c'est toute la différence entre la première page et le pipeline complet. Les lignes produit, elles, s'adressent par leur Product Attachment ID et pas par l'identifiant du produit, donc Get many products of a deal passe presque toujours avant un remove ou un update. Si le choix de la plateforme n'est pas encore tranché, l'Avis n8n détaille les arbitrages, et la Formation n8n reprend la construction de ces workflows pas à pas.

Connexion

Comment connecter Pipedrive à n8n ?

  1. 01

    Choisir la méthode d'authentification

    Le credential Pipedrive de n8n accepte deux méthodes : API Token et OAuth2. Le token est la voie courte pour un workflow interne sur un seul compte. OAuth2 s'impose dès que la connexion doit tourner sous une application déclarée, avec des scopes accordés objet par objet. Les deux alimentent le nœud et le trigger, et se créent une fois dans le menu Credentials.

  2. 02

    Copier ton token API personnel

    Ouvre API Personal Preferences dans Pipedrive et copie Your personal API token dans le credential n8n. Si le compte couvre plusieurs sociétés, sélectionne le nom du compte, vérifie que la bonne société s'affiche, puis passe par Company Settings, Personal Preferences et l'onglet API pour lire le token de cette société-là.

  3. 03

    Déclarer une application publique pour OAuth2

    OAuth2 part d'un compte developer sandbox Pipedrive. Dans le Developer Hub, choisis Create an app, puis Create public app, et nomme-la. Colle l'OAuth Redirect URL affichée par n8n dans le Callback URL de l'application, enregistre, active les scopes utiles, puis recopie le Client ID et le Client Secret dans n8n.

Déclencheurs

Sur quoi le Pipedrive Trigger se déclenche-t-il ?

Pipedrive Trigger est le nœud qui démarre un workflow quand quelque chose se passe dans Pipedrive. Il écoute 4 événements, listés ci-dessous par famille. Tu en choisis un ou plusieurs, tu actives le workflow : n8n enregistre le webhook (l'URL que Pipedrive appelle) sur ton compte.

Ce que tu vois dans n8n

Tous les événements, par famille

Une ligne par objet, une puce par action. L'événement à cocher dans le nœud s'écrit objet.action ; survole une puce pour lire quand il se déclenche.

added.*1
  • added.
    • added
deleted.*1
  • deleted.
    • deleted
merged.*1
  • merged.
    • merged
updated.*1
  • updated.
    • updated

Le trigger accepte aussi * (tout événement). Pratique pour du log, dangereux en production.

Notes de configuration

01Set up the Pipedrive TriggerLe trigger fonctionne par webhook, c'est-à-dire une URL que Pipedrive appelle au moment où quelque chose se passe. n8n enregistre cette URL auprès de Pipedrive à l'activation du workflow, et c'est pour ça que les événements ne tombent sur le canvas qu'une fois le workflow actif. Ensuite, chaque changement fait par un commercial arrive en quelques secondes.

Le trigger fonctionne par webhook, c'est-à-dire une URL que Pipedrive appelle au moment où quelque chose se passe. n8n enregistre cette URL auprès de Pipedrive à l'activation du workflow, et c'est pour ça que les événements ne tombent sur le canvas qu'une fois le workflow actif. Ensuite, chaque changement fait par un commercial arrive en quelques secondes.

Paramètres clés

  • Object : le type d'objet dont tu veux recevoir les notifications, choisi dans la liste du nœud.
  • Action : l'événement à capter, added, updated, merged ou deleted, avec une option joker qui garde les quatre.
  • Incoming Authentication : active l'authentification du webhook, ce qui rend l'URL plus difficile à utiliser pour quelqu'un qui n'est pas Pipedrive.
Quand l'utiliser
tout workflow qui doit répondre à un changement fait dans Pipedrive plutôt qu'à un horaire. Un nœud trigger par objet et par action garde la logique lisible.
02Catch Added eventsadded se déclenche quand une fiche de l'objet surveillé apparaît dans Pipedrive, peu importe qui l'a créée : un commercial dans l'interface, un import, ou un autre workflow qui appelle l'API. Le payload porte la fiche qui vient d'être créée, souvent suffisant tel quel, et une opération get complète le reste quand il faut le deal lié ou le propriétaire.

added se déclenche quand une fiche de l'objet surveillé apparaît dans Pipedrive, peu importe qui l'a créée : un commercial dans l'interface, un import, ou un autre workflow qui appelle l'API. Le payload porte la fiche qui vient d'être créée, souvent suffisant tel quel, et une opération get complète le reste quand il faut le deal lié ou le propriétaire.

Paramètres clés

  • Added : l'événement qui signale que des données ont été ajoutées pour l'objet surveillé.
  • Object : à régler avant l'action, parce que le même événement ne raconte pas la même chose sur un deal et sur une personne.
Cas d'usage
un deal créé lance la checklist interne et cale la réunion de lancement ; une personne créée est rapprochée des comptes déjà présents avant le moindre appel ; une activité créée par un commercial se recopie dans l'agenda que le reste de l'équipe consulte.
03Catch Updated eventsupdated se déclenche à chaque modification d'une fiche de l'objet surveillé. Chaque modification, y compris celles dont personne ne se soucie, donc le nœud qui suit le trigger est presque toujours un filtre qui ne garde que le champ surveillé. Sans lui, un workflow prévu pour les changements d'étape tourne aussi quand quelqu'un corrige une faute dans un titre.

updated se déclenche à chaque modification d'une fiche de l'objet surveillé. Chaque modification, y compris celles dont personne ne se soucie, donc le nœud qui suit le trigger est presque toujours un filtre qui ne garde que le champ surveillé. Sans lui, un workflow prévu pour les changements d'étape tourne aussi quand quelqu'un corrige une faute dans un titre.

Paramètres clés

  • Updated : l'événement qui signale que des données ont été mises à jour.
  • Action : le paramètre où l'événement se choisit ; ne laisse le joker que si le workflow traite vraiment les quatre cas.
Cas d'usage
un deal arrivé en dernière étape poste dans le canal commercial, une valeur qui franchit un seuil demande une relecture, un propriétaire modifié déplace la relance. À coupler avec une opération get quand la décision dépend de champs absents du payload.
04Catch Deleted and Merged eventsCes deux-là couvrent ce qui arrive quand des fiches disparaissent ou fusionnent. deleted dit que des données ont été supprimées, merged que des données ont fusionné, ce que produit une passe de déduplication. Les deux s'oublient facilement sur un premier workflow, et ce sont eux qui expliquent qu'une table miroir s'éloigne petit à petit de ce que contient vraiment le CRM.

Ces deux-là couvrent ce qui arrive quand des fiches disparaissent ou fusionnent. deleted dit que des données ont été supprimées, merged que des données ont fusionné, ce que produit une passe de déduplication. Les deux s'oublient facilement sur un premier workflow, et ce sont eux qui expliquent qu'une table miroir s'éloigne petit à petit de ce que contient vraiment le CRM.

Paramètres clés

  • Deleted : se déclenche quand une fiche de l'objet surveillé est supprimée.
  • Merged : se déclenche quand deux fiches de l'objet surveillé n'en font plus qu'une.
Cas d'usage
un deal supprimé retire la ligne qui le reflétait dans le tableau de reporting ; une organisation fusionnée impose de revérifier chaque fiche qui pointait vers l'ancienne, des deals ouverts jusqu'aux documents rattachés.
Actions

Que sait faire le nœud Pipedrive ?

Le nœud Pipedrive expose 49 opérations sur 9 ressources. Pour chacune : le nœud tel que tu le configures dans n8n, les champs obligatoires, et nos notes de terrain.

Matrice ressources × opérations
RessourceCreateGetGet ManyUpdateDeleteAddRemoveDownloadDuplicateSearch
Activity✓✓✓✓✓
Deal✓✓✓✓✓✓✓
Deal Product✓✓✓✓
File✓✓✓✓✓
Lead✓✓✓✓✓
Note✓✓✓✓✓
Organization✓✓✓✓✓✓
Person✓✓✓✓✓✓
Product✓✓✓✓✓✓

Activity

5 opérations
01

Create an activity

activity.create

Ce que tu vois dans n8n

Notes & cas d'usage

Pose un appel, un rendez-vous ou une tâche sur la timeline Pipedrive et renvoie l'activité créée avec son identifiant.

Paramètres clés

  • Subject : ce que le commercial lit dans sa liste, donc une formulation de tâche.
  • Type : le type d'activité, en texte libre (call, meeting).
  • Additional Fields : Deal ID, Person ID ou Organization Name or ID rattachent l'activité, Due Date attend une date au format YYYY-MM-DD et User Name or ID l'assigne à un autre commercial.
Cas d'usage
Une démo réservée depuis un formulaire crée l'appel avant même que le commercial ouvre le CRM, déjà daté et déjà rattaché au bon deal.
02

Delete an activity

activity.delete

Ce que tu vois dans n8n

Notes & cas d'usage

Supprime une activité. Elle quitte la timeline du deal, de la personne ou de l'organisation à laquelle elle était rattachée, et n8n renvoie l'identifiant retiré pour que le workflow le journalise.

Paramètres clés

  • Activity ID : l'identifiant numérique de l'activité, souvent {{ $json.id }} récupéré d'une recherche ou du trigger.
Cas d'usage
Un rendez-vous annulé côté agenda nettoie l'activité correspondante, la revue de pipeline ne montre plus un appel qui n'aura pas lieu.
03

Get an activity

activity.get

Ce que tu vois dans n8n

Notes & cas d'usage

Lit une seule activité et renvoie ses champs en un item : sujet, type, échéance, propriétaire et fiches liées.

Paramètres clés

  • Activity ID : l'activité à lire.
  • Show Raw Field Keys : désactivé, la sortie porte des noms lisibles ; activé, elle montre les clés de champ Pipedrive brutes et les IDs d'options, ce qu'il faut quand un nœud suivant fait un rapprochement sur une clé de champ personnalisé.
Cas d'usage
Le trigger ne donne qu'un identifiant : cette opération le transforme en fiche complète avant qu'un nœud IF choisisse la suite.
04

Get many activities

activity.getAll

Ce que tu vois dans n8n

Notes & cas d'usage

Renvoie une liste d'activités plutôt qu'une seule. La collection Filters coupe côté Pipedrive, donc moins de bruit traverse le reste du workflow.

Paramètres clés

  • Return All : coché, n8n enchaîne les pages de l'API Pipedrive et ramène toutes les activités ; décoché, Limit fixe le nombre maximal.
  • Filters : Start Date et End Date prennent des échéances au format YYYY-MM-DD, Done garde les activités terminées ou non, User Name or ID limite à un commercial et Deal ID à un deal.
Cas d'usage
Un récap du lundi remonte les activités de la semaine par commercial et les pose dans un tableau que personne n'a rempli à la main.
05

Update an activity

activity.update

Ce que tu vois dans n8n

Notes & cas d'usage

Modifie une activité existante et laisse intacts tous les champs que tu ne remplis pas.

Paramètres clés

  • Activity ID : l'activité à modifier.
  • Update Fields : Done la clôture, Due Date la replanifie, Subject et Type réécrivent l'en-tête, User Name or ID la transfère, Busy Flag marque le créneau occupé et Public Description ajoute le détail synchronisé avec l'agenda externe.
Cas d'usage
Un appel marqué comme passé dans la téléphonie bascule l'activité en terminé, la liste du commercial n'affiche plus que ce qui reste.

Deal

7 opérations
06

Create a deal

deal.create

Ce que tu vois dans n8n

Notes & cas d'usage

Ouvre un deal dans le pipeline et le renvoie avec son identifiant, prêt pour la suite du workflow.

Paramètres clés

  • Title : le nom du deal affiché sur la carte.
  • Associate With : organization ou person, le formulaire demande ensuite Organization ID ou Person ID.
  • Additional Fields : Value avec Currency (code de 3 caractères comme EUR), Stage Name or ID pour placer la carte, sans quoi le deal atterrit à la première étape du pipeline par défaut, Expected Close Date au format YYYY-MM-DD, et Visible To.
Cas d'usage
Une demande qualifiée ouvre le deal à la bonne étape avec le budget déjà renseigné, au lieu d'une ressaisie de ce que le prospect vient de taper.
07

Delete a deal

deal.delete

Ce que tu vois dans n8n

Notes & cas d'usage

Supprime un deal de Pipedrive. Rien ne le ramène ensuite, donc cette opération se place derrière une condition, jamais juste après un trigger.

Paramètres clés

  • Deal ID : l'identifiant numérique du deal à supprimer, issu d'une recherche ou d'un nœud Pipedrive précédent.
Cas d'usage
Les deals de test laissés par une reprise de données partent en une seule exécution, pas carte par carte.
08

Duplicate a deal

deal.duplicate

Ce que tu vois dans n8n

Notes & cas d'usage

Copie un deal existant dans un nouveau et renvoie la copie avec son propre identifiant. La copie arrive comme une carte neuve, un update derrière fixe les dates, la valeur et l'étape du nouveau cycle.

Paramètres clés

  • Deal ID : le deal qui sert de modèle.
Cas d'usage
Un renouvellement annuel qui reprend la même structure démarre d'une copie de la carte de l'an dernier.
09

Get a deal

deal.get

Ce que tu vois dans n8n

Notes & cas d'usage

Récupère un deal en entier : valeur, devise, étape, propriétaire, personne et organisation associées.

Paramètres clés

  • Deal ID : le deal à lire.
  • Show Raw Field Keys : bascule la sortie des noms lisibles vers les clés de champ Pipedrive brutes et les IDs d'options.
Cas d'usage
Avant d'annoncer un deal gagné dans un canal d'équipe, le workflow relit la carte pour que le message porte le vrai montant et la vraie étape.
10

Get many deals

deal.getAll

Ce que tu vois dans n8n

Notes & cas d'usage

Liste les deals, filtrés ou non. Tout ce que fait la collection Filters se passe côté Pipedrive, ce qui garde la charge légère.

Paramètres clés

  • Return All : coché, toutes les pages de résultats reviennent ; décoché, Limit décide combien de deals le nœud renvoie.
  • Filters : Status vaut all_not_deleted par défaut et accepte aussi open, won, lost ou deleted, Stage Name or ID garde une étape, User Name or ID un propriétaire, Predefined Filter Name or ID pointe un filtre déjà enregistré.
Cas d'usage
Une prévision hebdomadaire lit tous les deals ouverts et pousse les totaux par étape là où la réunion commerciale les regarde.
12

Update a deal

deal.update

Ce que tu vois dans n8n

Notes & cas d'usage

Réécrit les champs d'un deal déjà en pipeline et ne touche à rien d'autre.

Paramètres clés

  • Deal ID : la carte à modifier.
  • Update Fields : Status passe le deal en won, lost ou deleted, Lost Reason note pourquoi, Stage Name or ID le fait avancer, Value et Currency corrigent le montant, Expected Close Date décale l'échéance et User Name or ID change le propriétaire.
Cas d'usage
Une signature renvoyée par l'outil de signature électronique passe le statut en gagné et inscrit le montant final dans la même exécution.

Deal Product

4 opérations
13

Add a product to a deal

dealProduct.add

Ce que tu vois dans n8n

Notes & cas d'usage

Rattache une ligne produit à un deal, avec son prix et sa quantité, et renvoie le rattachement créé.

Paramètres clés

  • Deal ID : le deal qui reçoit la ligne.
  • Product ID : le produit pris dans le catalogue Pipedrive.
  • Item Price et Quantity : le prix pratiqué sur ce deal et le nombre d'unités.
  • Additional Fields : Discount avec Discount Type en percentage ou amount, Tax en pourcentage et Comments pour décrire la ligne.
Cas d'usage
Un devis validé côté facturation réécrit ses lignes dans le deal, la valeur de la carte colle à ce que le client a signé.
14

Get many products of a deal

dealProduct.getAll

Ce que tu vois dans n8n

Notes & cas d'usage

Relit les lignes produit rattachées à un deal, chacune avec son prix, sa quantité et l'identifiant de rattachement dont les autres opérations produit ont besoin.

Paramètres clés

  • Deal ID : le deal dont on lit les lignes.
  • Return All : coché pour toutes les lignes du deal ; décoché, Limit arrête le nœud plus tôt.
Cas d'usage
Avant de préparer une facture, le workflow lit les lignes du deal gagné et transforme chacune en ligne de facture.
15

Remove a product from a deal

dealProduct.remove

Ce que tu vois dans n8n

Notes & cas d'usage

Détache une ligne produit d'un deal. Le produit reste au catalogue, seul son lien avec ce deal disparaît.

Paramètres clés

  • Deal ID : le deal qui porte la ligne.
  • Product Attachment ID : l'identifiant du couple deal-produit, pas celui du produit. Get many products of a deal le renvoie, et c'est cette valeur qu'il faut passer ici.
Cas d'usage
Une option abandonnée en négociation sort du deal, la prévision retombe sur ce que le client achète vraiment.
16

Update a product in a deal

dealProduct.update

Ce que tu vois dans n8n

Notes & cas d'usage

Change une ligne déjà rattachée à un deal : prix, quantité, remise ou taxe.

Paramètres clés

  • Deal ID et Product Attachment ID : la ligne à modifier, avec l'identifiant deal-produit et non celui du produit.
  • Update Fields : Item Price et Quantity pour les conditions commerciales, Discount avec Discount Type, Tax en pourcentage et Comments pour la note attachée à la ligne.
Cas d'usage
Un tarif renégocié s'applique sur place, la valeur du deal suit sans supprimer puis réajouter le produit.

File

5 opérations
17

Create a file

file.create

Ce que tu vois dans n8n

Notes & cas d'usage

Envoie un fichier dans Pipedrive depuis les données binaires portées par le nœud précédent et le rattache à la fiche que tu désignes.

Paramètres clés

  • Input Binary Field : le nom du champ binaire d'entrée qui contient le fichier à écrire, celui que le nœud précédent a produit.
  • Additional Fields : Deal ID, Person ID, Organization Name or ID, Activity ID, Lead ID ou Product ID, selon ce à quoi le document appartient.
Cas d'usage
Un PDF signé reçu par mail atterrit sur le deal, le contrat vit à côté de la carte et plus dans une boîte mail.
18

Delete a file

file.delete

Ce que tu vois dans n8n

Notes & cas d'usage

Retire un fichier stocké sur une fiche Pipedrive. La fiche reste intacte, seule la pièce jointe part, et l'opération renvoie l'identifiant du fichier supprimé.

Paramètres clés

  • File ID : l'identifiant numérique du fichier à supprimer.
Cas d'usage
Une grille tarifaire périmée rattachée à une dizaine de deals disparaît en une passe, juste avant l'envoi de la nouvelle version.
19

Download a file

file.download

Ce que tu vois dans n8n

Notes & cas d'usage

Ramène le contenu d'un fichier Pipedrive dans le workflow sous forme de données binaires, prêt pour un nœud qui le lit ou le range ailleurs.

Paramètres clés

  • File ID : le fichier à télécharger.
  • Put Output File in Field : le nom du champ binaire de sortie où le fichier atterrit. Le nœud suivant lit ce champ, donc choisis un nom qu'il attend.
Cas d'usage
Un bon de commande rattaché au deal est extrait puis déposé dans le dossier que la compta ouvre vraiment.
20

Get a file

file.get

Ce que tu vois dans n8n

Notes & cas d'usage

Renvoie ce que Pipedrive sait d'un fichier, nom et description compris, mais pas le contenu binaire. C'est Download a file qui transporte les octets, et les deux s'enchaînent souvent.

Paramètres clés

  • File ID : le fichier à lire.
Cas d'usage
Le workflow lit le nom et la description avant de décider si le document vaut un téléchargement, ce qui évite de tirer une grosse pièce jointe pour rien.
21

Update a file

file.update

Ce que tu vois dans n8n

Notes & cas d'usage

Renomme un fichier ou réécrit ce qu'il annonce, sans avoir à le renvoyer.

Paramètres clés

  • File ID : le fichier à modifier.
  • Update Fields : Name fixe le nom visible du fichier et Description le texte affiché à côté.
Cas d'usage
Les documents qui arrivent avec un nom généré par la machine reçoivent un nom lisible, le commercial qui ouvre le deal sait quelle version a été signée.

Lead

5 opérations
22

Create a lead

lead.create

Ce que tu vois dans n8n

Notes & cas d'usage

Un lead, c'est une piste pas encore qualifiée, rangée dans Pipedrive avant qu'un deal existe. L'opération en crée une avec ce que le workflow vient de collecter.

Paramètres clés

  • Title : le nom sous lequel la piste apparaît dans la liste, souvent le nom de la société suivi du canal d'entrée.
  • Associate With : le choix entre organization et person commande le champ demandé juste après, Organization ID ou Person ID.
  • Value : le montant potentiel rattaché à la piste, rangé dans Additional Fields aux côtés de Expected Close Date au format YYYY-MM-DD.
Cas d'usage
une demande de devis crée la piste avec son montant estimé, attribuée via Owner Name or ID.
23

Delete a lead

lead.delete

Ce que tu vois dans n8n

Notes & cas d'usage

Les doublons s'accumulent vite quand deux formulaires alimentent la même liste. Cette opération supprime définitivement la piste visée.

Paramètres clés

  • Lead ID : l'identifiant de la piste à supprimer, une chaîne de caractères récupérée du nœud qui l'a trouvée ; le champ est requis, donc une valeur vide arrête l'exécution au lieu d'effacer au hasard.
Cas d'usage
un nettoyage hebdomadaire parcourt les pistes, garde la plus ancienne de chaque paire et supprime les copies.
24

Get a lead

lead.get

Ce que tu vois dans n8n

Notes & cas d'usage

Relire une piste par son identifiant donne l'état réel côté Pipedrive, pas la copie figée qu'une étape précédente trimballe depuis dix minutes.

Paramètres clés

  • Lead ID : le seul champ à remplir ; l'opération lit sans rien modifier, ce qui la rend sûre dans une boucle ou sur une branche de reprise.
Cas d'usage
avant d'envoyer une relance au propriétaire de la piste, le workflow la relit et annule le message si elle a déjà bougé.
25

Get many leads

lead.getAll

Ce que tu vois dans n8n

Notes & cas d'usage

La liste des pistes ressort en un item par piste, base de tout export et de toute synchronisation.

Paramètres clés

  • Return All : activé, n8n enchaîne les pages de l'API jusqu'à la dernière piste ; désactivé, Limit fixe le plafond.
  • Archived Status : not_archived pour ce qui est encore travaillé, archived pour ce qui a été mis de côté, all pour les deux.
  • Filters : réduit la lecture à la source par Owner Name or ID, Organization ID ou Person ID.
Cas d'usage
un point du lundi matin compte les pistes ouvertes d'un commercial et les verse dans un tableau de suivi.
26

Update a lead

lead.update

Ce que tu vois dans n8n

Notes & cas d'usage

Seuls les champs ouverts dans Update Fields partent vers Pipedrive. Le reste garde sa valeur, et c'est ce qui permet de repasser plusieurs fois sur une piste sans écraser ce qu'un commercial a saisi à la main.

Paramètres clés

  • Lead ID : la piste à modifier, requis même pour un seul champ.
  • Is Archived : sort la piste de la liste active sans la supprimer, la fin logique d'une branche qui conclut à un refus.
  • Title, Value et Expected Close Date : les trois champs qui rendent une piste lisible dans un prévisionnel une fois l'enrichissement passé.
Cas d'usage
un score revient d'une étape d'enrichissement et la piste reçoit son étiquette via Label Names or IDs.

Note

5 opérations
27

Create a note

note.create

Ce que tu vois dans n8n

Notes & cas d'usage

Une note, c'est la trace écrite qui rend une fiche relisable des mois plus tard. L'opération en crée une et la rattache à l'objet que le workflow a entre les mains.

Paramètres clés

  • Content : le texte de la note, seul champ requis, souvent assemblé par un nœud précédent à partir d'un compte rendu d'appel.
  • Deal ID, Person ID, Organization Name or ID et Lead ID : l'objet auquel la note s'accroche, tous dans Additional Fields.
  • Pinned to Deal : épingle la note en haut du deal au lieu de la laisser descendre dans l'historique.
Cas d'usage
un ticket support clôturé dépose son résumé sur la fiche du contact.
28

Delete a note

note.delete

Ce que tu vois dans n8n

Notes & cas d'usage

Certaines notes sont écrites par une automatisation et n'ont pas vocation à lui survivre : un brouillon déjà remplacé, une note posée sur la mauvaise fiche.

Paramètres clés

  • Note ID : l'identifiant numérique de la note, repris de l'étape qui l'a créée ou listée ; dans Pipedrive les notes portent un nombre quand les pistes portent une chaîne, impossible donc d'intervertir les deux.
Cas d'usage
un workflow de transcription efface sa note provisoire dès que la version relue est écrite sur le deal.
29

Get a note

note.get

Ce que tu vois dans n8n

Notes & cas d'usage

Quand l'étape suivante doit citer une note au mot près, elle commence par la relire ici plutôt que par la reconstituer.

Paramètres clés

  • Note ID : l'identifiant de la note à lire, un nombre ; l'opération ne demande rien d'autre et se place derrière n'importe quelle étape qui sait déjà quelle note elle veut.
Cas d'usage
une validation interne récupère la note laissée par le commercial et la recopie dans le message envoyé au responsable.
30

Get many notes

note.getAll

Ce que tu vois dans n8n

Notes & cas d'usage

Les notes reviennent en liste, filtrées côté Pipedrive plutôt que triées après coup dans le workflow.

Paramètres clés

  • Filters : Start Date et End Date au format YYYY-MM-DD bornent une période, tandis que Deal ID, Person ID ou Lead ID ne gardent que les notes d'une fiche.
  • Sort : update_time place les plus récentes en tête, content trie par ordre alphabétique, id suit l'ordre de création.
  • Return All : laissé décoché, Limit garde le lot petit pendant la mise au point.
Cas d'usage
un récapitulatif mensuel rassemble les notes écrites sur un compte et les passe à une étape de synthèse.
31

Update a note

note.update

Ce que tu vois dans n8n

Notes & cas d'usage

Modifier une note existante vaut mieux que d'en empiler une deuxième en dessous, surtout quand le workflow réécrit le même résumé après chaque appel.

Paramètres clés

  • Note ID : la note à modifier, requis.
  • Content : le texte de remplacement, ici rangé dans Update Fields alors qu'il était obligatoire à la création.
  • Pinned to Person et Pinned to Organization : changent l'endroit où la note s'affiche sans en réécrire une ligne.
Cas d'usage
une note qui porte l'avancement d'un démarrage client est réécrite à chaque étape, au lieu de laisser la fiche se remplir de fragments.

Organization

6 opérations
32

Create an organization

organization.create

Ce que tu vois dans n8n

Notes & cas d'usage

Les entreprises arrivent dans Pipedrive sous forme d'organisations, et le nœud en crée une avec un seul champ obligatoire.

Paramètres clés

  • Name : le nom de l'entreprise, requis ; c'est sur lui que porteront les recherches ensuite, donc le normaliser en amont évite les comptes en double.
  • Custom Fields : dans Additional Fields, l'endroit où passent le secteur, le segment ou tout champ ajouté par l'équipe commerciale.
  • Visible To : 1 réserve la fiche au propriétaire et à ses abonnés, 3 l'ouvre à toute l'entreprise.
Cas d'usage
un contrat signé crée le compte avec son propriétaire, avant que le deal et les contacts s'y rattachent.
33

Delete an organization

organization.delete

Ce que tu vois dans n8n

Notes & cas d'usage

Supprimer la fiche d'une entreprise est rare et rarement réversible : mieux vaut brancher l'opération derrière une validation humaine qu'en sortie directe d'un déclencheur.

Paramètres clés

  • Organization ID : l'identifiant numérique de l'organisation, jamais son nom ; une recherche passe donc souvent juste avant pour convertir l'un en l'autre.
Cas d'usage
une demande de suppression de données passe par un workflow qui attend l'accord d'un responsable avant d'effacer l'organisation.
34

Get an organization

organization.get

Ce que tu vois dans n8n

Notes & cas d'usage

Lire une organisation précise ramène le compte tel que Pipedrive le stocke, champs personnalisés compris.

Paramètres clés

  • Organization ID : le compte à lire, requis.
  • Show Raw Field Keys : activé, la sortie porte les clés brutes de Pipedrive et les identifiants d'options plutôt que les libellés lisibles, ce qu'attend en général une étape de mappage vers un autre outil.
Cas d'usage
avant d'émettre une facture, le workflow relit l'organisation pour récupérer les informations de facturation rangées dans ses champs personnalisés.
35

Get many organizations

organization.getAll

Ce que tu vois dans n8n

Notes & cas d'usage

Toute la liste des comptes sort d'un coup, point de départ classique d'un export, d'un audit ou d'un enrichissement.

Paramètres clés

  • Return All : coché, le nœud enchaîne les pages tout seul ; décoché, Limit décide du nombre d'organisations renvoyées.
  • Predefined Filter Name or ID : réutilise un filtre déjà construit dans Pipedrive, et la logique de sélection reste là où l'équipe la maintient.
  • First Character : un caractère unique qui ne garde que les organisations dont le nom commence par lui, pratique pour découper un gros export par lettre.
Cas d'usage
un audit trimestriel lit toutes les organisations et repère celles qui n'ont pas de propriétaire.
37

Update an organization

organization.update

Ce que tu vois dans n8n

Notes & cas d'usage

Les données d'un compte vieillissent vite : un rachat, un changement de nom, un nouveau propriétaire. L'opération écrit ces changements sur la fiche existante.

Paramètres clés

  • Organization ID : l'organisation à modifier, requis.
  • Name et Owner Name or ID : rangés dans Update Fields, envoyer l'un laisse l'autre intact.
  • Use Raw Field Keys : permet d'adresser les champs personnalisés par leurs clés Pipedrive et leurs identifiants d'options plutôt que par leurs noms lisibles, plus stable quand les libellés changent.
Cas d'usage
un enrichissement mensuel rafraîchit les étiquettes des comptes via Label Names or IDs.

Person

6 opérations
38

Create a person

person.create

Ce que tu vois dans n8n

Notes & cas d'usage

Les contacts vivent dans l'objet person, et le nœud en crée un à partir d'un nom, tout le reste restant facultatif.

Paramètres clés

  • Name : le nom du contact, seul champ obligatoire.
  • Emails et Phones : des collections et non des champs texte, parce qu'un contact porte souvent une adresse professionnelle et une personnelle, un fixe et un mobile.
  • Organization Name or ID : rattache le contact à un compte dès la création, ce qui évite un raccrochage manuel plus tard.
Cas d'usage
une inscription à un webinaire crée le contact avec son email et son téléphone, déjà rattaché à l'organisation identifiée par le formulaire.
39

Delete a person

person.delete

Ce que tu vois dans n8n

Notes & cas d'usage

Un contact qui demande à disparaître, ou un doublon créé par deux intégrations en même temps, sort de la base par cette opération.

Paramètres clés

  • Person ID : l'identifiant numérique du contact à supprimer, le plus souvent résolu une étape plus tôt par une recherche sur l'adresse email.
Cas d'usage
une demande de désinscription atterrit dans une file, une personne la valide, puis le workflow supprime le contact.
40

Get a person

person.get

Ce que tu vois dans n8n

Notes & cas d'usage

Un seul contact revient, lu par son identifiant, avec les champs que l'équipe commerciale y entretient.

Paramètres clés

  • Person ID : le contact à lire, requis.
  • Show Raw Field Keys : renvoie les clés brutes et les identifiants d'options à la place des libellés, pratique quand le nœud suivant attend des clés stables.
Cas d'usage
une séquence email relit le contact avant chaque envoi, et personne ne reçoit un message qui parle de son ancienne société.
41

Get many persons

person.getAll

Ce que tu vois dans n8n

Notes & cas d'usage

Une synchronisation, une segmentation ou une chasse aux emails manquants commencent toutes pareil, en lisant la base de contacts en masse.

Paramètres clés

  • Return All : activé, tous les contacts remontent page après page ; désactivé, Limit garde l'exécution courte pendant les réglages.
  • Filters : Predefined Filter Name or ID réutilise un filtre enregistré dans Pipedrive, et First Character ne garde que les contacts dont le nom commence par la lettre donnée.
Cas d'usage
un contrôle trimestriel liste les contacts sans numéro de téléphone et envoie la liste à l'équipe qui les complète.
43

Update a person

person.update

Ce que tu vois dans n8n

Notes & cas d'usage

Les numéros changent, les gens partent ailleurs, les étiquettes sont refaites. L'opération applique ces corrections sur un contact déjà en base.

Paramètres clés

  • Person ID : le contact à modifier, seul champ requis.
  • Emails et Phones : envoyés sous forme de collections, donc le contact peut porter plusieurs adresses et plusieurs numéros.
  • Visible To : 1 pour le propriétaire et ses abonnés, 3 pour toute l'entreprise.
Cas d'usage
une réponse à une campagne rattache le contact à sa nouvelle organisation et change son propriétaire via Owner Name or ID.

Product

6 opérations
44

Create a product

product.create

Ce que tu vois dans n8n

Notes & cas d'usage

Le catalogue Pipedrive se remplit depuis un workflow. Seul le nom est exigé : le code, les prix, la taxe et l'unité se rangent dans Additional Fields.

Paramètres clés

  • Name : le libellé que l'équipe commerciale voit en rattachant le produit à une affaire ; vide, il bloque l'exécution.
  • Additional Fields : Code pour la référence interne, Unit pour l'unité de vente, Tax pour le pourcentage de taxe, Prices pour les tarifs et Owner ID pour le propriétaire de la fiche.
  • Visible To : 1 réserve le produit à son propriétaire et à ses abonnés, 3 l'ouvre à toute l'entreprise.
Cas d'usage
ajouter une prestation au catalogue dès qu'elle est validée dans le tableau de tarifs interne.
45

Delete a product

product.delete

Ce que tu vois dans n8n

Notes & cas d'usage

Supprimer une fiche produit tient en un paramètre. Attention au format : Pipedrive attend l'identifiant numérique, pas le nom du produit, donc la valeur vient d'une étape qui l'a retrouvé juste avant.

Paramètres clés

  • Product ID : le numéro de la fiche à supprimer, souvent {{ $json.id }} récupéré d'une recherche ou d'une liste placée en amont.
Cas d'usage
faire le ménage après un import en double, une fois qu'un nœud précédent a désigné la fiche à conserver.
46

Get a product

product.get

Ce que tu vois dans n8n

Notes & cas d'usage

Cette opération lit une fiche produit et met ses champs à disposition du reste du workflow. De quoi construire un devis ou une alerte interne avec l'unité et la taxe réellement enregistrées, plutôt qu'avec une valeur ressaisie.

Paramètres clés

  • Product ID : la fiche à lire, sous forme de nombre ; une expression comme {{ $json.product_id }} la reprend du nœud précédent.
  • Show Raw Field Keys : décoché, la sortie affiche des noms lisibles ; coché, elle renvoie les clés de champ Pipedrive brutes et les identifiants d'option, format pratique quand un script prend le relais.
Cas d'usage
vérifier le produit rattaché à une affaire avant qu'une relance parte, pour que le montant annoncé colle au catalogue.
47

Get many products

product.getAll

Ce que tu vois dans n8n

Notes & cas d'usage

Get Many ramène les produits du compte, un item par fiche, sans filtre à renseigner. La seule question à trancher, c'est le volume.

Paramètres clés

  • Return All : coché, n8n enchaîne les pages de l'API jusqu'au dernier produit ; décoché, Limit fixe le nombre maximal de fiches renvoyées.
  • Show Raw Field Keys : le même interrupteur que sur la lecture unitaire, appliqué à chaque item de la liste.
Cas d'usage
alimenter chaque semaine un rapport de catalogue, ou compter les produits en base avant une révision tarifaire.
49

Update a product

product.update

Ce que tu vois dans n8n

Notes & cas d'usage

La mise à jour n'envoie que les champs que tu poses dans Update Fields. Corriger un tarif ne touche donc ni la référence, ni l'unité, ni le propriétaire de la fiche.

Paramètres clés

  • Product ID : la fiche à modifier, identifiée par son numéro Pipedrive.
  • Update Fields : reprend les attributs de la création, Name compris, qui devient facultatif ici puisque rien n'oblige à renommer le produit.
  • Use Raw Field Keys : à activer quand les valeurs entrantes utilisent déjà les clés de champ Pipedrive brutes et les identifiants d'option.
Cas d'usage
répercuter un nouveau taux de taxe sur les fiches concernées, une exécution par produit, sans passer par l'interface.
Besoin d'aide

Besoin d'aide pour automatiser Pipedrive avec n8n ?

L'équipe te répond directement.

Chaque message est lu par une personne.

FAQ

Pipedrive et n8n, les questions qui suivent

01L'intégration Pipedrive n8n est-elle gratuite ?
Oui côté n8n. Le nœud Pipedrive et le Pipedrive Trigger sont livrés avec n8n : rien à installer, rien à payer en plus pour le connecteur lui-même, sur n8n Cloud comme sur une instance auto-hébergée en Community Edition sous licence Sustainable Use. Un workflow construit d'un côté tourne pareil de l'autre, ce qui compte quand un test sur Cloud finit par rentrer en interne. Ce que coûte un abonnement Pipedrive est une autre question, et cette page ne la traite pas. Le credential, la connexion enregistrée une fois dans le menu Credentials, se réutilise dans tous les workflows qui touchent au CRM.
02Quels credentials Pipedrive faut-il dans n8n ?
Deux méthodes fonctionnent : API Token et OAuth2. Pour le token, ouvre API Personal Preferences dans Pipedrive et copie ton token API personnel dans le credential n8n. Si le compte couvre plusieurs sociétés, vérifie d'abord que tu regardes la bonne, puis passe par Company Settings, Personal Preferences et l'onglet API. OAuth2 démarre d'un compte developer sandbox Pipedrive : dans le Developer Hub, crée une application publique, nomme-la, colle l'OAuth Redirect URL affichée par n8n comme Callback URL de l'application, active les scopes utiles, puis recopie le Client ID et le Client Secret dans n8n. Le même credential sert au nœud et au trigger.
03Quelles sont les limites du nœud Pipedrive dans n8n ?
Le nœud couvre 49 opérations sur 9 ressources : activités, deals, produits de deal, fichiers, leads, notes, organisations, personnes et produits. Tout ce que l'API Pipedrive expose en dehors de cette liste reste joignable avec le nœud HTTP Request, qui réutilise le même credential Pipedrive via l'authentification prédéfinie, sans second jeton à gérer. Dans le nœud, les opérations de liste s'arrêtent à Limit tant que Return All n'est pas coché, et une recherche de deals demande un Term d'au moins 2 caractères. Les lignes produit s'adressent par leur Product Attachment ID et non par l'ID du produit, un détail à vérifier avant de lancer un remove sur des données réelles.
04Le Pipedrive Trigger réagit-il en temps réel ?
Oui. Le Pipedrive Trigger fonctionne par webhook : n8n enregistre son URL auprès de Pipedrive à l'activation du workflow, et chaque événement arrive sur le canvas quelques secondes plus tard, sans boucle d'interrogation entre les deux. Tu choisis l'Object à surveiller et l'Action à capter parmi added, updated, merged et deleted, ou le joker qui garde les quatre. Incoming Authentication active l'authentification du webhook et le rend plus sûr. Comme l'URL est enregistrée à l'activation, un workflow laissé inactif ne reçoit rien : c'est l'explication habituelle quand un test reste silencieux.
05n8n ou Make pour Pipedrive ?
Ça dépend surtout de l'endroit où le workflow doit vivre. n8n s'auto-héberge en Docker ou en npm, ou tourne sur n8n Cloud, et le workflow est identique dans les deux cas : les fiches du CRM peuvent rester sur une infrastructure que tu maîtrises quand c'est une contrainte. Make est hébergé uniquement, sans option d'auto-hébergement, et se facture à l'opération, ce qui change le calcul d'une synchronisation déclenchée à chaque modification de deal. Les deux offrent un canvas visuel. La comparaison se joue sur l'hébergement, la maîtrise des données, le modèle de coût et la logique visuelle, pas sur la longueur du catalogue.