- Accueil
- Ressources
- Intégrations
- Salesforce
Intégration Salesforce n8nAutomatiser Salesforce avec n8n.
Jusqu'où n8n pilote-t-il Salesforce ? L'intégration Salesforce n8n ouvre 65 opérations sur 12 objets, des comptes aux cas, et un trigger qui surveille 18 événements répartis en 9 familles. De quoi arrêter les recopies à la main entre deux onglets, côté commerce comme côté support.
Avis vérifiés sur Trustpilot · Agence IA, automatisation & growth
Que couvre vraiment l'intégration Salesforce n8n ?
Deux nœuds sont livrés avec n8n. Le nœud Salesforce exécute 65 opérations sur 12 objets : comptes, contacts, leads, opportunités, cas, tâches, pièces jointes, documents, flows, utilisateurs, objets personnalisés et recherche SOQL. Le nœud Salesforce Trigger, lui, démarre un workflow (une automatisation enchaînant plusieurs étapes) quand un enregistrement apparaît ou change, sur 18 événements regroupés en 9 familles.
Premier scénario, le pipeline qui ne se raconte plus à la main. Le trigger écoute opportunityUpdated, le workflow lit la nouvelle étape, et un message part dans le canal commercial via Slack. Personne n'a plus à signaler qu'un deal a bougé.
Deuxième scénario, le ménage dans les comptes. Un export comptable vit dans Google Sheets, et account.upsert écrit chaque ligne en la comparant à un champ de correspondance : si le compte existe, il est mis à jour ; sinon il est créé. Le stock de doublons arrête de grossir.
Troisième scénario, le suivi commercial. Après un rendez-vous, account.addNote pose le compte rendu sur la fiche du client. Le contexte reste sur l'enregistrement et pas dans la boîte mail d'une seule personne.
Le nœud couvre ces 12 objets, rien de plus. Pour un objet qui n'a pas d'opération dédiée, le nœud HTTP Request appelle n'importe quel endpoint de l'API Salesforce en réutilisant le même credential (l'identifiant de connexion enregistré une fois dans n8n). Les champs personnalisés, eux, restent accessibles sans détour : ouvre Additional Fields, ajoute un champ, puis choisis Custom Fields dans la liste.
Deux limites à connaître avant de construire. Les opérations Get Many s'arrêtent à Limit tant que Return All n'est pas activé, et un export tronqué ne prévient pas. Le trigger, lui, fonctionne par interrogation régulière : un enregistrement remonte après l'intervalle choisi, pas à la seconde où il est enregistré. Si le choix de plateforme n'est pas tranché, l'Avis n8n traite l'hébergement et le coût, la Formation n8n couvre la prise en main, et les mêmes montages se transposent à Pipedrive avec d'autres noms de champs.
Comment connecter Salesforce à n8n ?
- 01
Choisir la méthode d'authentification
Le credential accepte deux méthodes : OAuth2, et OAuth2 JWT pour une connexion de serveur à serveur qui ne redemande jamais à un humain de se reconnecter. Pour des workflows qui tournent sans surveillance, c'est JWT qu'il faut monter. Quatre valeurs suffisent : l'Environment Type (Production ou Sandbox), le Username Salesforce, un Client ID et une Private Key associée à un certificat auto-signé.
- 02
Créer une External Client App côté Salesforce
Dans Setup, tape App Manager dans la Quick Find box et sélectionne New External Client App. Renseigne les Basic Info : un Name et une Contact Email address. Sous API (Enable OAuth Settings), active Enable OAuth et indique l'URL de callback
http://localhost:1717/OauthRedirect, ou celle de ton instance si tu héberges n8n. Coche les scopes Full access (full) et Perform requests at any time, active le JWT Bearer Flow, puis charge ton certificat. - 03
Reporter les valeurs dans n8n
Récupère la Consumer Key de l'application et colle-la dans n8n comme Client ID. Colle ensuite le contenu du fichier de clé privée dans Private Key, avec l'éditeur multiligne et au format PEM standard, lignes d'en-tête et de fin comprises. Le credential se crée une fois depuis le menu Credentials : les deux nœuds le proposent ensuite dans leur liste déroulante, le trigger comme le nœud d'action.
Qu'est-ce qui peut déclencher un workflow Salesforce ?
Salesforce Trigger est le nœud qui démarre un workflow quand quelque chose se passe dans Salesforce. Il écoute 18 é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 Salesforce 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.
account.*2attachment.*2case.*2contact.*2custom.*2lead.*2opportunity.*2task.*2user.*2Notes de configuration
01Set up the Salesforce Trigger
Le nœud trigger écoute un type d'événement et sort un item par enregistrement trouvé. Rien n'est déclaré côté Salesforce : aucune URL de rappel à coller quelque part.
Paramètres clés
- Trigger On : l'événement écouté par ce workflow, parmi les 18 disponibles. Ils se répartissent en 9 familles de deux, création et modification, pour les comptes, les pièces jointes, les cas, les contacts, les objets personnalisés, les leads, les opportunités, les tâches et les utilisateurs.
- Poll Times : la fréquence à laquelle n8n demande à l'API Salesforce si du nouveau existe, au plus une fois par minute. Il n'y a pas d'option « tous les événements » : un nœud trigger écoute un événement.
02On Lead Created and On Lead Updated
C'est par les leads que commence la plupart des automatisations commerciales. leadCreated se déclenche quand un lead entre dans l'org, peu importe l'origine : formulaire web, import, saisie d'un commercial. leadUpdated se déclenche quand un lead existant est modifié, changement de statut compris.
03On Opportunity Created and On Opportunity Updated
Les mouvements de pipeline passent par deux événements. opportunityCreated attrape l'affaire au moment où elle s'ouvre, opportunityUpdated attrape toutes les modifications suivantes, y compris les changements d'étape qui comptent pour les prévisions.
04On Case Created and On Case Updated
Le support a sa propre paire. caseCreated se déclenche sur chaque nouveau cas, y compris ceux ouverts par email ou depuis un formulaire, et caseUpdated sur toute modification d'un cas existant. Là encore, n8n interroge l'API à l'intervalle fixé dans Poll Times, donc le cas remonte au tour de scrutation suivant.
05On Custom Object Created and On Custom Object Updated
Peu d'orgs tournent uniquement sur les objets standards. Ces deux événements portent sur les enregistrements d'un objet défini en interne : customObjectCreated pour une création, customObjectUpdated pour la modification d'un enregistrement existant.
Paramètres clés
- Custom Object Name or ID : requis, il indique au trigger quel objet surveiller. Choisis-le dans la liste que n8n charge depuis l'org, ou fournis un ID par une expression (la syntaxe
{{ $json.champ }}qui va chercher une donnée dans l'item entrant) quand l'objet dépend d'une étape précédente. Comme ce champ est requis, le trigger refuse de démarrer tant qu'aucun objet n'est choisi, ce qui évite un workflow qui surveille le vide.
Que sait faire le nœud Salesforce ?
Le nœud Salesforce expose 65 opérations sur 12 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 Comment | Add Note | Add Contact To Campaign | Get Summary | Invoke | Query | Upload | Create or Update |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Account | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | |||||
| Attachment | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | |||||||
| Case | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ||||||
| Contact | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ||||
| Custom Object | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | |||||||
| Document | ✓ | ||||||||||||
| Flow | ✓ | ✓ | |||||||||||
| Lead | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ||||
| Opportunity | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | |||||
| Search | ✓ | ||||||||||||
| Task | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | |||||||
| User | ✓ | ✓ |
Sommaire des opérations
Account
8 opérationsAdd a note to an account
account.addNoteCe que tu vois dans n8n
Notes & cas d'usage
Accroche une note à un compte existant, pour que le contexte reste sur la fiche plutôt que dans une boîte mail.
Paramètres clés
- Account ID : l'enregistrement auquel la note se rattache, souvent
{{ $json.id }}repris d'un nœud Salesforce précédent. - Title : requis, et c'est ce que le commercial voit dans la liste, donc autant qu'il soit précis.
- Body : optionnel, limité à 32 KB, largement au-delà de ce que pèse un compte rendu.
- Is Private : à true, la note n'est visible que par son propriétaire et par les utilisateurs disposant de la permission Modify All Data.
Create an account
account.createCe que tu vois dans n8n
Notes & cas d'usage
Crée un compte et renvoie l'enregistrement complet, identifiant compris, prêt à alimenter le nœud suivant.
Paramètres clés
- Name : le seul champ requis, plafonné à 255 caractères.
- Additional Fields : 26 champs optionnels, dont Phone, Website, Industry, Annual Revenue, Number Of Employees, Owner et tout le bloc d'adresses Billing et Shipping.
- Custom Fields : se trouve dans Additional Fields et donne accès aux champs ajoutés par l'administrateur de l'org.
Create or update an account
account.upsertCe que tu vois dans n8n
Notes & cas d'usage
Une seule opération qui tranche toute seule : elle cherche un compte existant, le met à jour si elle le trouve, et en crée un sinon.
Paramètres clés
- Match Against : le champ vérifié pour savoir si le compte existe déjà, en général un identifiant externe géré par l'autre système.
- Value to Match : la valeur recherchée dans ce champ pour l'item en cours.
- Name : toujours requis, puisque c'est avec lui que l'enregistrement est créé en cas d'absence.
Delete an account
account.deleteCe que tu vois dans n8n
Notes & cas d'usage
Supprime un compte de l'org. Le nœud ne demande aucune confirmation : l'exécution part dès que le workflow arrive dessus.
Paramètres clés
- Account ID : l'enregistrement à supprimer. Mieux vaut passer un identifiant lu dans la même exécution qu'un identifiant stocké ailleurs, parce qu'un ID périmé échoue ou, pire, vise le mauvais enregistrement.
Get an account
account.getCe que tu vois dans n8n
Notes & cas d'usage
Lit un compte et renvoie ses champs. C'est l'étape que les workflows de mise à jour oublient le plus souvent, et qu'ils regrettent ensuite.
Paramètres clés
- Account ID : l'enregistrement à lire, en général repris de l'item du trigger ou d'un résultat de recherche.
Get many accounts
account.getAllCe que tu vois dans n8n
Notes & cas d'usage
Ramène une liste de comptes en une exécution, avec de quoi filtrer les lignes comme les colonnes.
Paramètres clés
- Return All : activé, n8n enchaîne les pages de l'API jusqu'à épuiser la liste ; désactivé, il s'arrête à Limit.
- Limit : le nombre maximal de comptes renvoyés quand Return All est désactivé.
- Fields : les champs à inclure, séparés par des virgules. Demande les cinq qui servent, pas la fiche entière.
- Conditions : restreint les comptes renvoyés.
Get an account summary
account.getSummaryCe que tu vois dans n8n
Notes & cas d'usage
Renvoie un aperçu des métadonnées de l'objet Account, et non des comptes. Aucun paramètre à remplir, ce qui en fait un moyen rapide de voir comment l'objet est réellement construit dans l'org.
Update an account
account.updateCe que tu vois dans n8n
Notes & cas d'usage
Modifie les champs d'un compte déjà en base, sans toucher à ceux qui ne sont pas nommés.
Paramètres clés
- Account ID : l'enregistrement à modifier.
- Update Fields : 27 champs disponibles ici, un de plus qu'à la création, parce que Name devient modifiable au lieu d'être requis.
- Owner Name or ID : réattribue le compte, et c'est le champ auquel se résument la plupart des workflows de territoire.
Attachment
6 opérationsCreate an attachment
attachment.createCe que tu vois dans n8n
Notes & cas d'usage
Envoie un fichier et l'attache à un enregistrement. Le fichier circule en binaire dans le workflow, sans stockage intermédiaire.
Paramètres clés
- Parent ID : l'enregistrement auquel le fichier se rattache, un compte, un cas, ou tout objet qui accepte les pièces jointes.
- Name : affiché sous le libellé File Name, plafonné à 255 caractères.
- Input Binary Field : le nom du champ binaire qui contient le fichier, soit
datatant qu'un nœud précédent ne l'a pas renommé. - Is Private : à true, le fichier n'est visible que par son propriétaire et les administrateurs.
Delete an attachment
attachment.deleteCe que tu vois dans n8n
Notes & cas d'usage
Détache et efface définitivement un fichier de l'org.
Paramètres clés
- Attachment ID : il désigne le fichier lui-même, pas l'enregistrement qui le porte. Il se récupère via une étape de liste dans le même workflow, parce que la fiche parente ne le fournit pas d'elle-même.
Get an attachment
attachment.getCe que tu vois dans n8n
Notes & cas d'usage
Récupère une pièce jointe à partir de son identifiant.
Paramètres clés
- Attachment ID : le fichier à lire, en général un identifiant repris d'une étape de liste ou du trigger quand c'est un événement de pièce jointe qui a lancé l'exécution.
Get many attachments
attachment.getAllCe que tu vois dans n8n
Notes & cas d'usage
Liste les pièces jointes, ce qui reste la façon concrète de savoir ce qui est classé où.
Paramètres clés
- Conditions : le filtre qui rend cette opération utile, sans quoi la liste remonte des fichiers de toute l'org.
- Return All : désactivé par défaut, auquel cas Limit plafonne le nombre de fichiers renvoyés.
- Fields : les colonnes à inclure, séparées par des virgules.
Get an attachment summary
attachment.getSummaryCe que tu vois dans n8n
Notes & cas d'usage
Décrit l'objet Attachment tel qu'il existe dans l'org, sous forme d'aperçu de ses métadonnées, sans aucun paramètre à renseigner.
Update an attachment
attachment.updateCe que tu vois dans n8n
Notes & cas d'usage
Remplace le contenu ou les métadonnées d'une pièce jointe existante.
Paramètres clés
- Attachment ID : le fichier à modifier.
- Name : renomme le fichier, toujours dans la limite de 255 caractères.
- Description : un texte de description, limité à 255 caractères.
- Input Binary Field : renseigné, il remplace le fichier stocké par le binaire entrant, ce qui conserve le même enregistrement de pièce jointe au lieu d'en créer un second.
Case
7 opérationsAdd a comment to a case
case.addCommentCe que tu vois dans n8n
Notes & cas d'usage
Poste un commentaire sur un cas, la façon qu'a un workflow de parler dans le fil de support plutôt qu'à côté.
Paramètres clés
- Case ID : le cas qui reçoit le commentaire.
- Comment Body : affiché sous le libellé Body, le texte du commentaire.
- Is Published : à true, le commentaire devient visible par les clients dans le portail Self-Service ; à false, il reste interne. Ce champ mérite une relecture avant d'envoyer un message de diagnostic.
Create a case
case.createCe que tu vois dans n8n
Notes & cas d'usage
Ouvre un cas depuis n'importe quelle source que le workflow sait atteindre : un formulaire, une alerte de supervision, un email entrant.
Paramètres clés
- Type Name or ID : le seul champ requis, choisi dans la liste définie par l'org.
- Additional Fields : 17 champs optionnels, dont Subject, Description, Priority, Status, Case Origin, Contact ID et Account ID.
- Supplied Email : l'adresse saisie à la création. Elle n'est plus modifiable ensuite, donc autant la renseigner dans ce nœud plutôt que de compter la corriger plus tard.
Delete a case
case.deleteCe que tu vois dans n8n
Notes & cas d'usage
Efface un cas et, avec lui, le fil qui lui est rattaché.
Paramètres clés
- Case ID : le cas à retirer. Le filtre se construit avant ce nœud, jamais après : une fois l'exécution passée, il n'y a rien à annuler.
Get a case
case.getCe que tu vois dans n8n
Notes & cas d'usage
Charge un cas avec la valeur actuelle de ses champs.
Paramètres clés
- Case ID : le cas à lire.
Get many cases
case.getAllCe que tu vois dans n8n
Notes & cas d'usage
Rapatrie une liste de cas, matière première des workflows de reporting et de suivi d'arriéré.
Paramètres clés
- Return All : laissé désactivé, le nœud s'arrête à Limit, et c'est la raison habituelle d'un rapport hebdomadaire étrangement plat.
- Limit : plafonne le nombre de cas renvoyés.
- Conditions : restreint la liste, par statut ou par propriétaire par exemple.
- Fields : les champs à inclure, séparés par des virgules.
Get a case summary
case.getSummaryCe que tu vois dans n8n
Notes & cas d'usage
Inspecte les métadonnées de l'objet Case au lieu de renvoyer des cas, et ne demande aucun paramètre.
Update a case
case.updateCe que tu vois dans n8n
Notes & cas d'usage
Met à jour un cas existant, ce à quoi aboutit la majorité des automatisations de support.
Paramètres clés
- Case ID : le cas à modifier.
- Update Fields : 18 champs ici, un de plus qu'à la création, puisque Type passe dans les champs optionnels.
- Status Name or ID : le champ qui pilote directement l'indicateur IsClosed, donc fermer un cas revient à le renseigner.
- Is Escalated : bascule le cas en escalade, ce qui permet à un contrôle par règle de le confier à un responsable.
Contact
9 opérationsAdd a contact to a campaign
contact.addToCampaignCe que tu vois dans n8n
Notes & cas d'usage
Dans Salesforce, l'appartenance à une campagne est un enregistrement à part, pas une case sur la fiche contact. Cette opération crée ce lien : le contact entre dans la liste des membres, sans qu'aucun de ses champs soit réécrit.
Paramètres clés
- Contact ID : l'identifiant du contact à inscrire, en général
{{ $json.id }}venu du nœud précédent. - Campaign Name or ID : choisis la campagne dans la liste que n8n charge depuis ton org, ou passe un identifiant par expression.
- Status, dans Options : pilote l'indicateur HasResponded de cette inscription.
Add a note to a contact
contact.addNoteCe que tu vois dans n8n
Notes & cas d'usage
Une note est du texte libre rattaché à un enregistrement, sans passer par un champ de la fiche. Le nœud en crée une et l'accroche au contact visé.
Paramètres clés
- Contact ID : la fiche qui reçoit la note.
- Title : le titre, seul élément visible dans la liste associée.
- Body, dans Options : le corps de la note, limité à 32 Ko.
- Is Private : activé, seuls le propriétaire de la note et un utilisateur ayant la permission Modify All Data peuvent la lire ou l'interroger via l'API.
- Owner Name or ID : l'utilisateur propriétaire de la note.
Create a contact
contact.createCe que tu vois dans n8n
Notes & cas d'usage
Un item entrant, une fiche contact créée. Le nœud renvoie l'identifiant Salesforce généré, que les étapes suivantes réutilisent pour y accrocher une note, une tâche ou un fichier.
Paramètres clés
- Last Name : le seul champ obligatoire, limité à 80 caractères. Vide, il bloque l'exécution du nœud.
- Additional Fields : 37 champs facultatifs, dont Email, Phone, Title et Account Name or ID, celui qui rattache le contact à un compte parent.
- Custom Fields : les champs ajoutés par ton administrateur, un couple Field Name or ID et Value à la fois.
Create or update a contact
contact.upsertCe que tu vois dans n8n
Notes & cas d'usage
Synchroniser des personnes venues d'un autre outil finit presque toujours en doublons. L'upsert règle ça : Salesforce cherche d'abord une correspondance, et ne crée la fiche que s'il n'en trouve aucune.
Paramètres clés
- Match Against : le champ que Salesforce interroge pour savoir si le contact existe déjà, à choisir dans la liste.
- Value to Match : la valeur recherchée dans ce champ. Trouvée, le contact est mis à jour ; absente, une fiche est créée.
- Last Name : toujours obligatoire, toujours limité à 80 caractères.
- Additional Fields : les mêmes 37 champs facultatifs, appliqués dans les deux cas.
Delete a contact
contact.deleteCe que tu vois dans n8n
Notes & cas d'usage
La suppression part sans filet côté workflow : le nœud envoie l'ordre et passe à l'item suivant, rien ne se rattrape en aval.
Paramètres clés
- Contact ID : l'identifiant de l'enregistrement, pas l'adresse email ni le nom complet. Alimente-le depuis une opération de lecture ou depuis l'item du trigger plutôt qu'à la main.
Get a contact
contact.getCe que tu vois dans n8n
Notes & cas d'usage
Un identifiant en entrée, la fiche complète en sortie. Utile dès qu'un nœud suivant a besoin de champs que l'item de départ ne transporte pas.
Paramètres clés
- Contact ID : l'enregistrement à récupérer, souvent
{{ $json.id }}venu du nœud d'avant. Ce champ est du texte libre, contrairement aux listes déroulantes du reste du nœud : une mauvaise valeur se traduit par une exécution en erreur, pas par un résultat vide.
Get many contacts
contact.getAllCe que tu vois dans n8n
Notes & cas d'usage
Lecture en masse, un item par contact renvoyé. Ce qui sort dépend entièrement du réglage de la pagination et du filtre.
Paramètres clés
- Return All : coché, n8n enchaîne les pages de l'API et ramène tous les contacts correspondants ; décoché, il s'arrête à Limit.
- Limit : le nombre maximal de contacts renvoyés quand Return All est décoché.
- Conditions, dans Options : filtre la requête pour ne remonter qu'une partie de la base.
- Fields : la liste des champs à inclure, séparés par des virgules, ce qui allège sérieusement la sortie sur une grosse org.
Get a contact summary
contact.getSummaryCe que tu vois dans n8n
Notes & cas d'usage
Celle-ci ne renvoie pas de contacts mais un aperçu des métadonnées de l'objet Contact. Aucune ligne à traiter derrière, et rien à paramétrer non plus : la question à laquelle elle répond porte sur la structure de l'objet dans ton org, pas sur les personnes qu'il contient.
Update a contact
contact.updateCe que tu vois dans n8n
Notes & cas d'usage
Les champs que tu renseignes sont écrasés, les autres gardent leur valeur. Cette mise à jour partielle rend l'opération supportable sur des fiches que d'autres équipes modifient aussi.
Paramètres clés
- Contact ID : la fiche à modifier.
- Update Fields : 38 champs facultatifs, un de plus qu'à la création, parce que Last Name bascule ici et n'est plus obligatoire.
- Email Opt Out : indique que le contact ne souhaite plus recevoir d'email depuis Salesforce, à brancher sur ce qu'écrit ta page de désinscription.
Custom Object
6 opérationsCreate a custom object
customObject.createCe que tu vois dans n8n
Notes & cas d'usage
Les objets personnalisés sont les tables que ton administrateur a ajoutées à l'org. Le nœud les traite comme n'importe quelle ressource : tu désignes l'objet, tu remplis ses champs, tu récupères l'enregistrement créé.
Paramètres clés
- Custom Object Name or ID : l'objet dans lequel écrire, proposé dans une liste chargée depuis ton org, ce qui évite de deviner son nom d'API.
- Fields : les valeurs à poser, ajoutées une par une sous forme de couple Field Name or ID et Value.
- Record Type Name or ID, dans Additional Fields : le type d'enregistrement visé quand l'objet en définit plusieurs.
Create or update a custom object
customObject.upsertCe que tu vois dans n8n
Notes & cas d'usage
Même logique d'upsert, appliquée cette fois à une table maison : Salesforce tranche entre création et mise à jour en regardant un champ que tu désignes, ce qui rend un import rejouable sans dégât.
Paramètres clés
- Custom Object Name or ID : l'objet ciblé.
- Match Against : le champ contrôlé pour savoir si l'enregistrement existe déjà.
- Value to Match : présente dans ce champ, l'enregistrement est mis à jour ; absente, il est créé.
- Fields : les valeurs écrites dans les deux cas, en couples Field Name or ID et Value.
Delete a custom object
customObject.deleteCe que tu vois dans n8n
Notes & cas d'usage
Deux identifiants sont nécessaires ici, pas un : l'objet indique la table concernée, l'identifiant d'enregistrement désigne la ligne à retirer.
Paramètres clés
- Custom Object Name or ID : l'objet personnalisé qui contient l'enregistrement.
- Record ID : l'enregistrement à supprimer. Ce champ est du texte libre, il vient donc normalement d'une lecture antérieure plutôt que d'une saisie.
Get a custom object
customObject.getCe que tu vois dans n8n
Notes & cas d'usage
Un seul enregistrement lu dans une table maison, renvoyé comme un item avec ses champs. À combiner avec une étape de recherche quand l'identifiant n'est pas déjà dans les données.
Paramètres clés
- Custom Object Name or ID : l'objet personnalisé où lire, sélectionné dans la liste.
- Record ID : l'enregistrement à récupérer.
Get many custom objects
customObject.getAllCe que tu vois dans n8n
Notes & cas d'usage
Lecture en masse sur une table maison, avec les mêmes interrupteurs de pagination que les ressources standard, plus un sélecteur de champs qui connaît le schéma de ton org.
Paramètres clés
- Custom Object Name or ID : l'objet à interroger.
- Return All : activé, toutes les pages sont récupérées ; désactivé, Limit plafonne le nombre d'enregistrements.
- Conditions, dans Options : restreint la requête aux lignes qui t'intéressent.
- Field Names or IDs : une sélection multiple des champs à inclure, prise dans la liste ou fournie en identifiants par expression.
Update a custom object
customObject.updateCe que tu vois dans n8n
Notes & cas d'usage
La modification se fait champ par champ sur un enregistrement que tu désignes, et tout ce que tu ne listes pas reste en l'état.
Paramètres clés
- Custom Object Name or ID : l'objet dans lequel vit l'enregistrement.
- Record ID : l'enregistrement à mettre à jour.
- Fields : chaque changement exprimé en couple Field Name or ID et Value, y compris pour poser un Record Type Name or ID quand l'objet en propose plusieurs.
Document
1 opérationUpload a document
document.uploadCe que tu vois dans n8n
Notes & cas d'usage
Entre deux nœuds n8n, un fichier voyage dans une propriété binaire portant un nom. Cette opération prend cette propriété et la dépose dans Salesforce sous forme de document.
Paramètres clés
- Input Binary Field : le nom du champ binaire de l'item entrant qui contient le fichier. Nom erroné, le nœud n'a rien à envoyer.
- Title : le nom du fichier tel qu'il sera stocké.
- File Extension, dans Additional Fields : impose une extension ; laissé vide, c'est celle des données binaires qui sert.
- Link To Object ID : rattache le document à un enregistrement existant.
- Owner Name or ID : l'utilisateur propriétaire du document.
Flow
2 opérationsGet many flows
flow.getAllCe que tu vois dans n8n
Notes & cas d'usage
Un flow, c'est une automatisation construite à l'intérieur de Salesforce. Cette opération en dresse la liste, essentiellement pour retrouver le nom d'API nécessaire avant d'en déclencher un.
Paramètres clés
- Return All : coché, le nœud parcourt toute la liste des flows ; décoché, Limit fixe le nombre de résultats.
- Limit : le nombre maximal de flows renvoyés.
Invoke a flow
flow.invokeCe que tu vois dans n8n
Notes & cas d'usage
Plutôt que de reconstruire la logique métier de l'org dans n8n, cette opération rend la main à Salesforce : le nœud appelle un flow, et le flow travaille avec les règles de l'org.
Paramètres clés
- API Name : le nom d'API du flow, obligatoire, et précisément la valeur que l'opération de liste sert à récupérer.
- JSON Parameters : bascule la saisie des variables entre l'interface clé-valeur et du JSON brut.
- Variables : les variables d'entrée transmises au flow, ajoutées une à une ou écrites en objet JSON selon cette bascule.
Lead
9 opérationsAdd a lead to a campaign
lead.addToCampaignCe que tu vois dans n8n
Notes & cas d'usage
Rattacher un lead existant à une campagne crée le membre de campagne côté Salesforce, et le lead entre dans l’audience de l’opération sans que personne ouvre le CRM.
Paramètres clés
- Lead ID : l’identifiant Salesforce du lead à rattacher, souvent
{{ $json.Id }}repris d’un nœud Salesforce précédent. - Campaign Name or ID : la campagne se choisit dans la liste que n8n charge depuis ton org, ou se passe par expression quand elle change d’une exécution à l’autre.
- Status : rangé dans Options, il pilote l’indicateur HasResponded du membre de campagne.
Add a note to a lead
lead.addNoteCe que tu vois dans n8n
Notes & cas d'usage
Une note créée ici reste sur la fiche du lead, lisible par toute personne qui l’ouvre, au lieu de dormir dans une boîte mail.
Paramètres clés
- Lead ID : désigne le lead auquel la note appartient.
- Title : le titre de la note, seul texte visible tant que personne ne la déplie.
- Body : le contenu, limité à 32 Ko, l’endroit où atterrit un compte rendu d’appel ou un commentaire de formulaire.
- Is Private : à true, seuls le propriétaire de la note et un utilisateur ayant la permission Modify All Data peuvent la lire ou l’interroger via l’API.
Create a lead
lead.createCe que tu vois dans n8n
Notes & cas d'usage
Deux champs suffisent à faire entrer un lead dans Salesforce : Company et Last Name. Le reste passe par Additional Fields, qui en propose 27.
Paramètres clés
- Company : la société du lead. Laissé vide, et si les types d’enregistrement de compte personnel sont activés dans l’org, le lead se convertit en compte personnel.
- Last Name : limité à 80 caractères.
- Email et Lead Source Name or ID : tous deux optionnels, tous deux dans Additional Fields, et le second décide de ce que racontera l’attribution trois mois plus tard.
Create or update a lead
lead.upsertCe que tu vois dans n8n
Notes & cas d'usage
Le même prospect remplit deux formulaires et voilà deux leads. Create or Update cherche d’abord, écrit ensuite.
Paramètres clés
- Match Against : le champ que n8n vérifie pour savoir si le lead existe déjà.
- Value to Match : la valeur recherchée dans ce champ. Trouvée, le lead est mis à jour. Absente, un nouveau lead est créé.
- Company et Last Name : toujours obligatoires, puisque n’importe quelle exécution peut finir en création.
Delete a lead
lead.deleteCe que tu vois dans n8n
Notes & cas d'usage
La suppression ne se rattrape pas côté n8n : le nœud envoie la demande puis passe à l’item suivant. Mieux vaut un filtre solide avant lui.
Paramètres clés
- Lead ID : l’identifiant de l’enregistrement, pas l’adresse email ni le nom de la société. Il vient en général d’un Get Many placé juste avant, ou du trigger sous la forme
{{ $json.Id }}.
Get a lead
lead.getCe que tu vois dans n8n
Notes & cas d'usage
Il suffit d’un identifiant pour récupérer la fiche complète du lead, en un seul item. Pratique quand un outil en amont n’a transmis qu’un ID.
Paramètres clés
- Lead ID : l’enregistrement à récupérer. Une expression comme
{{ $json.leadId }}garde le workflow générique d’une exécution à l’autre.
Get many leads
lead.getAllCe que tu vois dans n8n
Notes & cas d'usage
Get Many parcourt l’objet Lead et renvoie un item par enregistrement, point de départ habituel d’un traitement par lot qui note ou répartit.
Paramètres clés
- Return All : activé, n8n enchaîne les pages de l’API jusqu’au dernier lead. Désactivé, Limit fixe le nombre maximal d’items renvoyés.
- Conditions : les filtres qui gardent le lot sur les leads qui méritent le traitement.
- Fields : les champs à inclure, séparés par des virgules, de quoi alléger la charge sur une org bien remplie.
Get a lead summary
lead.getSummaryCe que tu vois dans n8n
Notes & cas d'usage
Aucune fiche ne revient ici. Get Summary renvoie un aperçu des métadonnées de l’objet Lead, sa structure plutôt que son contenu, et ne demande aucun paramètre.
Update a lead
lead.updateCe que tu vois dans n8n
Notes & cas d'usage
Update n’écrit que ce que tu envoies : les champs absents d’Update Fields gardent leur valeur actuelle, et une charge partielle passe sans risque.
Paramètres clés
- Lead ID : l’enregistrement à modifier.
- Status Name or ID : l’un des 29 champs d’Update Fields, choisi dans la liste de statuts définie par l’org.
- Rating et Owner Name or ID : les deux que les workflows de répartition écrivent le plus, l’un pour la priorité, l’autre pour le commercial qui prend la suite.
Opportunity
8 opérationsAdd a note to an opportunity
opportunity.addNoteCe que tu vois dans n8n
Notes & cas d'usage
Sur une affaire, les commentaires arrivent de plusieurs personnes à la fois. Cette opération en pose un sur la fiche, là où le commercial ira le chercher.
Paramètres clés
- Opportunity ID : l’affaire à laquelle la note se rattache.
- Title : obligatoire, et à modéliser pour que la liste des notes reste lisible.
- Body : jusqu’à 32 Ko de texte.
- Owner Name or ID : l’utilisateur propriétaire de la note, utile quand un credential partagé signerait sinon toutes les notes de la même façon.
Create an opportunity
opportunity.createCe que tu vois dans n8n
Notes & cas d'usage
Trois champs ouvrent une affaire : un nom, une date de clôture, une étape. Les 13 champs d’Additional Fields complètent le prévisionnel autour.
Paramètres clés
- Name : limité à 80 caractères.
- Close Date : la date de clôture attendue, une vraie date et non du texte libre.
- Stage Name or ID : à prendre dans les étapes configurées par l’org.
- Amount et Account Name or ID : optionnels tous les deux, à remplir quand même si le rapport de pipeline doit vouloir dire quelque chose.
Create or update an opportunity
opportunity.upsertCe que tu vois dans n8n
Notes & cas d'usage
Même mécanique que du côté des leads, appliquée aux affaires : n8n cherche une opportunité existante et n’en crée une que si la recherche ne donne rien.
Paramètres clés
- Match Against et Value to Match : le champ vérifié, et la valeur recherchée dedans.
- Name, Close Date et Stage Name or ID : obligatoires en plus de la correspondance, puisque l’exécution peut finir en création.
Delete an opportunity
opportunity.deleteCe que tu vois dans n8n
Notes & cas d'usage
Supprimer une affaire fausse tous les historiques de pipeline construits dessus, d’où l’étape « perdue » que préfèrent la plupart des équipes. Les doublons restent le vrai motif.
Paramètres clés
- Opportunity ID : l’identifiant de l’affaire à retirer, lu le plus souvent dans un Get Many dont le filtre a déjà fait le tri.
Get an opportunity
opportunity.getCe que tu vois dans n8n
Notes & cas d'usage
Lire une affaire renvoie son montant, son étape et ses dates du moment, soit ce qu’il faut au workflow avant de décider quoi que ce soit.
Paramètres clés
- Opportunity ID : l’enregistrement à lire. Venant du trigger, il arrive sous forme d’expression, par exemple
{{ $json.Id }}.
Get many opportunities
opportunity.getAllCe que tu vois dans n8n
Notes & cas d'usage
Get Many sort les opportunités en items séparés, prêtes à être additionnées, regroupées ou envoyées là où l’équipe commerciale regarde déjà.
Paramètres clés
- Conditions : le filtre qui rend l’opération utile, par exemple pour ne garder qu’une étape du cycle.
- Return All : activé, n8n enchaîne les pages jusqu’au bout. Désactivé, Limit décide combien d’affaires reviennent.
- Fields : séparés par des virgules, pour ramener le montant et la date de clôture sans le reste de la fiche.
Get an opportunity summary
opportunity.getSummaryCe que tu vois dans n8n
Notes & cas d'usage
Get Summary décrit l’objet Opportunity, pas une affaire en particulier : il renvoie un aperçu de ses métadonnées, sans aucun paramètre à remplir.
Update an opportunity
opportunity.updateCe que tu vois dans n8n
Notes & cas d'usage
Faire avancer une affaire tient le plus souvent à un seul champ, et Update Fields en propose 16.
Paramètres clés
- Opportunity ID : l’affaire à modifier.
- Stage Name or ID : ce qu’une automatisation de pipeline écrit le plus souvent.
- Amount : le montant total estimé de la vente, à rafraîchir dès que le devis bouge.
- Next Step : la description de la prochaine action pour conclure, limitée à 255 caractères.
Search
1 opérationPerform a query
search.queryCe que tu vois dans n8n
Notes & cas d'usage
Query exécute une requête SOQL et renvoie tous ses résultats en une seule réponse, ce qui couvre les lectures que les opérations par ressource ne savent pas exprimer.
Paramètres clés
- Query : la chaîne SOQL, du genre
SELECT+Name+FROM+MyObject. Une requête invalide renvoie une réponse MALFORMED_QUERY, donc autant la tester dans Salesforce avant de la brancher.
Task
6 opérationsCreate a task
task.createCe que tu vois dans n8n
Notes & cas d'usage
Un seul champ est obligatoire pour créer une tâche : son statut. Les 25 champs d’Additional Fields font tout le reste.
Paramètres clés
- Status Name or ID : le statut courant, In Progress ou Completed par exemple, pris dans la liste de l’org.
- Subject Name or ID : l’objet de la tâche, limité à 255 caractères.
- Activity Date : la date d’échéance, toujours horodatée à minuit en UTC.
- Who ID : pointe vers une personne, lead ou contact, là où What ID pointe vers un compte, une opportunité ou un cas.
Delete a task
task.deleteCe que tu vois dans n8n
Notes & cas d'usage
Les tâches s’accumulent plus vite que n’importe quel autre objet d’un CRM, et celle-ci part définitivement.
Paramètres clés
- Task ID : la tâche à retirer. À alimenter depuis un Get Many dont les Conditions ont déjà réduit la liste, puisque rien ne demande de confirmation ici.
Get a task
task.getCe que tu vois dans n8n
Notes & cas d'usage
Récupérer une tâche donne son statut, son objet et les enregistrements auxquels elle est reliée.
Paramètres clés
- Task ID : l’identifiant de la tâche à lire, repris en général de l’item du trigger.
Get many tasks
task.getAllCe que tu vois dans n8n
Notes & cas d'usage
Get Many liste les tâches une par item, et c’est comme ça qu’un workflow sait ce que l’équipe a encore sur le feu.
Paramètres clés
- Return All : activé, n8n redemande des pages jusqu’à la dernière tâche. Désactivé, Limit l’arrête plus tôt.
- Conditions : les filtres qui restreignent le lot à un propriétaire ou à un statut.
- Fields : les champs à renvoyer, séparés par des virgules.
Get a task summary
task.getSummaryCe que tu vois dans n8n
Notes & cas d'usage
Comme ses équivalents sur les leads et les opportunités, cet appel renvoie un aperçu des métadonnées de l’objet Task, et pas une seule tâche.
Update a task
task.updateCe que tu vois dans n8n
Notes & cas d'usage
Update réécrit les champs fournis et laisse les autres tranquilles, parmi les 26 disponibles dans Update Fields.
Paramètres clés
- Task ID : la tâche à modifier.
- Status Name or ID : ce que la plupart des automatisations écrivent, pour clore une tâche depuis l’extérieur de Salesforce.
- Is ReminderSet : active ou coupe le rappel en popup, et Reminder Date Time fixe le moment où il se déclenche.
User
2 opérationsGet a user
user.getCe que tu vois dans n8n
Notes & cas d'usage
Une seule fiche utilisateur Salesforce est ramenée à partir de son identifiant, puis transmise telle quelle au nœud suivant. De quoi remplacer un identifiant brut par les informations de la personne avant la suite du workflow.
Paramètres clés
- User ID : l'identifiant de l'utilisateur à récupérer, le plus souvent une expression du type
{{ $json.userId }}(une expression n8n va chercher la valeur dans l'item qui arrive du nœud précédent).
Get many users
user.getAllCe que tu vois dans n8n
Notes & cas d'usage
Là, le nœud parcourt les utilisateurs de l'org et sort un item par utilisateur. C'est la base de tout workflow qui répartit des enregistrements entre plusieurs personnes.
Paramètres clés
- Return All : activé, n8n enchaîne les pages de l'API jusqu'au dernier utilisateur ; désactivé, Limit fixe le nombre d'utilisateurs renvoyés.
- Conditions : filtre la liste côté Salesforce, une condition par ligne ajoutée avec Add Condition.
- Fields : les champs à inclure, séparés par des virgules, pour ne pas trimballer toute la fiche.
Besoin d'aide pour automatiser Salesforce avec n8n ?
L'équipe te répond directement.
Chaque message est lu par une personne.



