- Accueil
- Ressources
- Intégrations
- Pipedrive
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
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.
Comment connecter Pipedrive à n8n ?
- 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.
- 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à.
- 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.
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.*1added.added
deleted.*1deleted.deleted
merged.*1merged.merged
updated.*1updated.updated
Le trigger accepte aussi * (tout événement). Pratique pour du log, dangereux en production.
Notes de configuration
01Set up the Pipedrive Trigger
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,mergedoudeleted, 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.
02Catch Added events
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.
03Catch Updated events
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.
04Catch Deleted and Merged events
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.
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.
| Ressource | Create | Get | Get Many | Update | Delete | Add | Remove | Download | Duplicate | Search |
|---|---|---|---|---|---|---|---|---|---|---|
| Activity | ✓ | ✓ | ✓ | ✓ | ✓ | |||||
| Deal | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | |||
| Deal Product | ✓ | ✓ | ✓ | ✓ | ||||||
| File | ✓ | ✓ | ✓ | ✓ | ✓ | |||||
| Lead | ✓ | ✓ | ✓ | ✓ | ✓ | |||||
| Note | ✓ | ✓ | ✓ | ✓ | ✓ | |||||
| Organization | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ||||
| Person | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ||||
| Product | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
Sommaire des opérations
Activity
5 opérationsCreate an activity
activity.createCe 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-DDet User Name or ID l'assigne à un autre commercial.
Delete an activity
activity.deleteCe 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.
Get an activity
activity.getCe 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é.
Get many activities
activity.getAllCe 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.
Update an activity
activity.updateCe 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.
Deal
7 opérationsCreate a deal
deal.createCe 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 :
organizationouperson, 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.
Delete a deal
deal.deleteCe 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.
Duplicate a deal
deal.duplicateCe 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.
Get a deal
deal.getCe 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.
Get many deals
deal.getAllCe 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_deletedpar défaut et accepte aussiopen,won,lostoudeleted, 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é.
Search deals
deal.searchCe que tu vois dans n8n
Notes & cas d'usage
Cherche des deals à partir de texte libre, comme la barre de recherche Pipedrive, et renvoie chaque correspondance en item.
Paramètres clés
- Term : le texte cherché, 2 caractères minimum, 1 si Exact Match est activé. La recherche ignore la casse.
- Search Fields :
title,notesoucustom_fields, tous par défaut. - Return All et Limit : le duo habituel quand un terme vague remonte trop de résultats.
- Additional Fields : Organization ID ou Person ID restreignent à un compte, Include Fields ajoute des données optionnelles comme
deal.cc_email.
Update a deal
deal.updateCe 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,lostoudeleted, 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.
Deal Product
4 opérationsAdd a product to a deal
dealProduct.addCe 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
percentageouamount, Tax en pourcentage et Comments pour décrire la ligne.
Get many products of a deal
dealProduct.getAllCe 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.
Remove a product from a deal
dealProduct.removeCe 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.
Update a product in a deal
dealProduct.updateCe 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.
File
5 opérationsCreate a file
file.createCe 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.
Delete a file
file.deleteCe 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.
Download a file
file.downloadCe 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.
Get a file
file.getCe 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.
Update a file
file.updateCe 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é.
Lead
5 opérationsCreate a lead
lead.createCe 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
organizationetpersoncommande 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.
Delete a lead
lead.deleteCe 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.
Get a lead
lead.getCe 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.
Get many leads
lead.getAllCe 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_archivedpour ce qui est encore travaillé,archivedpour ce qui a été mis de côté,allpour les deux. - Filters : réduit la lecture à la source par Owner Name or ID, Organization ID ou Person ID.
Update a lead
lead.updateCe 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é.
Note
5 opérationsCreate a note
note.createCe 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.
Delete a note
note.deleteCe 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.
Get a note
note.getCe 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.
Get many notes
note.getAllCe 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-DDbornent une période, tandis que Deal ID, Person ID ou Lead ID ne gardent que les notes d'une fiche. - Sort :
update_timeplace les plus récentes en tête,contenttrie par ordre alphabétique,idsuit l'ordre de création. - Return All : laissé décoché, Limit garde le lot petit pendant la mise au point.
Update a note
note.updateCe 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.
Organization
6 opérationsCreate an organization
organization.createCe 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 :
1réserve la fiche au propriétaire et à ses abonnés,3l'ouvre à toute l'entreprise.
Delete an organization
organization.deleteCe 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.
Get an organization
organization.getCe 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.
Get many organizations
organization.getAllCe 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.
Search organizations
organization.searchCe que tu vois dans n8n
Notes & cas d'usage
Chercher vaut mieux que lister quand le workflow tient un nom et cherche le compte correspondant, par exemple pour ne pas créer deux fois la même entreprise.
Paramètres clés
- Term : le texte recherché, deux caractères minimum, ou un seul si Exact Match est activé.
- Exact Match : ne renvoie que les correspondances complètes du terme, sans tenir compte de la casse.
- Search Fields : limite la recherche à
name,address,notesoucustom_fields; laissé vide, tous ces champs sont interrogés.
Update an organization
organization.updateCe 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.
Person
6 opérationsCreate a person
person.createCe 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.
Delete a person
person.deleteCe 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.
Get a person
person.getCe 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.
Get many persons
person.getAllCe 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.
Search persons
person.searchCe que tu vois dans n8n
Notes & cas d'usage
Quand le workflow connaît une adresse email mais pas l'identifiant Pipedrive de la personne, cette recherche comble le manque.
Paramètres clés
- Term : le texte recherché, deux caractères au minimum, ou un seul avec Exact Match activé.
- Search Fields :
email,phone,name,notesoucustom_fields. Se limiter àemailévite vite les homonymes. - Organization ID : ne garde que les contacts d'un compte.
- Include Fields : ajoute des données optionnelles absentes par défaut, comme
person.picture.
Update a person
person.updateCe 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 :
1pour le propriétaire et ses abonnés,3pour toute l'entreprise.
Product
6 opérationsCreate a product
product.createCe 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 :
1réserve le produit à son propriétaire et à ses abonnés,3l'ouvre à toute l'entreprise.
Delete a product
product.deleteCe 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.
Get a product
product.getCe 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.
Get many products
product.getAllCe 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.
Search products
product.searchCe que tu vois dans n8n
Notes & cas d'usage
La recherche travaille sur du texte, pas sur un identifiant. C'est le passage obligé quand un nom de produit arrive écrit à la main, par formulaire ou par email.
Paramètres clés
- Term : le texte cherché, deux caractères au minimum, un seul si Exact Match est activé.
- Exact Match : limite la réponse aux correspondances complètes du terme, sans tenir compte de la casse.
- Search Fields : restreint la recherche à
name,codeoucustom_fields, les trois étant interrogés par défaut ; Include Fields ajoute des champs optionnels aux résultats.
Update a product
product.updateCe 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.
Besoin d'aide pour automatiser Pipedrive avec n8n ?
L'équipe te répond directement.
Chaque message est lu par une personne.

