Intégration Copper n8nAutomatiser Copper avec n8n.
Ton CRM peut se tenir à jour tout seul. L'intégration Copper n8n pose un nœud de 32 opérations réparties sur 8 ressources, des entreprises aux opportunités en passant par les leads. Un second nœud écoute 3 événements, et une seule clé d'API alimente les deux.
Avis vérifiés sur Trustpilot · Agence IA, automatisation & growth
Que fait concrètement l'intégration Copper n8n ?
L'intégration Copper n8n branche ton CRM sur n'importe quel workflow n8n, autrement dit sur n'importe quelle suite d'étapes qui tourne sans que personne clique. Un nœud lit et écrit les entreprises, les personnes, les leads, les opportunités, les projets, les tâches, les sources client et les utilisateurs, soit 32 opérations. Un second nœud, le Copper Trigger, démarre le workflow dès qu'un enregistrement apparaît, change ou disparaît côté Copper.
Commence par le reporting, c'est là que le gain se voit le plus vite. opportunity.getAll avec Return All activé parcourt toutes les pages de l'API et livre le pipeline complet au nœud suivant. Branche Google Sheets derrière et la photo du lundi matin se construit pendant que l'équipe dort. Return All désactivé, c'est Limit qui décide du nombre d'enregistrements ramenés, ce qui suffit largement pendant les tests.
Deuxième famille de workflows : la notification. Le Copper Trigger se déclenche sur un enregistrement modifié, un nœud If trie ce qui mérite d'être relayé, et le message part dans le canal commercial. Même logique côté e-mail avec SendGrid quand il s'agit de prévenir quelqu'un qui ne vit pas dans le CRM.
Troisième famille : l'acquisition. Un formulaire, un export publicitaire ou une campagne Mautic arrive dans n8n, le nœud exécute lead.create avec un Name, et le lead est dans Copper avant que quiconque ouvre un onglet.
Deux choses à savoir avant de construire. Ce qui sort des 32 opérations du catalogue passe par le nœud HTTP Request, qui appelle n'importe quel endpoint de l'API Copper en réutilisant le credential déjà enregistré, c'est-à-dire l'identifiant de connexion stocké une fois dans n8n. Et le trigger se règle sur une Resource, l'objet qu'il surveille, à choisir avant d'activer le workflow.
Tu hésites encore sur la plateforme ? L'Avis n8n détaille ce que l'auto-hébergement change sur le coût et sur la maîtrise des données, le vrai critère dès qu'un CRM est dans la boucle.
Comment connecter Copper à n8n ?
- 01
Générer la clé d'API dans Copper
Le credential réclame un compte Copper au niveau Professional ou Business. Ouvre les réglages de ton compte Copper et génère une clé d'API en suivant l'article du support Copper consacré à la génération d'une clé. Copie-la tout de suite, c'est la valeur que n8n va stocker. Retiens aussi quel utilisateur l'a générée : son adresse e-mail est la seconde moitié du credential.
- 02
Enregistrer le credential dans n8n
Dans n8n, ouvre le menu Credentials et crée un credential Copper. Deux valeurs sont demandées : API Key, la clé que tu viens de générer, et Email, l'adresse de la personne qui a créé cette clé et pas une boîte partagée. Une fois enregistré, le credential apparaît dans la liste déroulante du nœud Copper comme dans celle du Copper Trigger, sur tous les workflows de l'instance.
- 03
Tester avec une lecture avant tout le reste
Pose un nœud Copper sur le canvas, sélectionne le credential, puis choisis une lecture sans risque : Customer Source avec Get Many. Exécute le nœud seul. Si des enregistrements reviennent, la clé et l'adresse e-mail se répondent bien. Il ne reste qu'à changer Resource et Operation pour ce dont le workflow a vraiment besoin.
Qu'est-ce qui déclenche un workflow Copper ?
Copper Trigger est le nœud qui démarre un workflow quand quelque chose se passe dans Copper. Il écoute 3 é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 Copper 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.
delete.*1delete.delete
new.*1new.new
update.*1update.update
Notes de configuration
01Set up the Copper Trigger
Le Copper Trigger en est à sa version 1 et fonctionne par webhook, c'est-à-dire une URL exposée par n8n que Copper appelle. n8n enregistre cette URL auprès de Copper au moment où tu actives le workflow : les événements arrivent en quelques secondes, rien n'est interrogé en boucle par n8n.
Paramètres clés
- Resource : requis, il désigne l'objet que le trigger surveille. Un nœud surveille une ressource, donc ce choix se fait avant l'activation.
- Event : le changement qui t'intéresse sur cette ressource. Il y en a 3 et aucune option joker, donc réagir à plusieurs types de changement suppose plusieurs sélections ou plusieurs nœuds trigger.
02Update
Se déclenche dès qu'un champ change sur un enregistrement existant. C'est le plus bavard des 3 événements, tout simplement parce qu'une fiche CRM est modifiée bien plus souvent qu'elle n'est créée.
Paramètres clés
- Event : choisis
update. Il couvre n'importe quel champ de la fiche, pas un champ précis, donc un nœud If ou Switch juste derrière fait presque toujours le tri. - Resource : l'objet modifié. Sur les opportunités, c'est ce réglage qui transforme un changement d'étape en notification.
person.update. Le volume grimpe vite, alors filtre tôt. Un bon tri en entrée vaut mieux qu'un journal d'exécutions qu'on relit le vendredi soir.03New
Part dès qu'un enregistrement est créé sur la ressource choisie. Copper pousse la fiche vers l'URL du webhook n8n dès son existence, qu'elle ait été saisie à la main, importée ou écrite par un autre workflow.
Paramètres clés
- Resource : l'objet créé. Surveiller les nouvelles entreprises et les nouvelles personnes demande deux nœuds trigger distincts.
- Event : choisis
new. Il ne couvre que la création, donc une fiche retouchée cinq minutes après ne le redéclenche pas.
04Delete
Signale la suppression d'un enregistrement existant. Le plus discret des 3 événements, et celui qui épargne le plus de ménage plus tard.
Paramètres clés
- Event : choisis
delete. Il annonce la disparition, donc le workflow travaille sur ce qui arrive et non sur une fiche qu'il pourrait relire. - Resource : l'objet retiré, le plus souvent des personnes ou des entreprises quand une campagne de nettoyage tourne.
Ce que le nœud Copper sait faire
Le nœud Copper expose 32 opérations sur 8 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 |
|---|---|---|---|---|---|
| Company | ✓ | ✓ | ✓ | ✓ | ✓ |
| Customer Source | ✓ | ||||
| Lead | ✓ | ✓ | ✓ | ✓ | ✓ |
| Opportunity | ✓ | ✓ | ✓ | ✓ | ✓ |
| Person | ✓ | ✓ | ✓ | ✓ | ✓ |
| Project | ✓ | ✓ | ✓ | ✓ | ✓ |
| Task | ✓ | ✓ | ✓ | ✓ | ✓ |
| User | ✓ |
Sommaire des opérations
Company
5 opérationsCreate a company
company.createCe que tu vois dans n8n
Notes & cas d'usage
Crée une entreprise dans Copper et transmet la fiche créée au nœud suivant.
Paramètres clés
- Name : seul champ requis, le nom tel qu'il doit apparaître dans le CRM. Il se mappe en général avec
{{ $json.field }}. - Additional Fields : bloc optionnel qui porte Email Domain, Details, Address et Phone Numbers. Les deux derniers s'ouvrent en sous-blocs à remplir ligne par ligne, via Add Address Fields et Add Phone Number.
Delete a company
company.deleteCe que tu vois dans n8n
Notes & cas d'usage
Retire définitivement une entreprise de Copper. À traiter comme une fin de branche, pas comme une étape au milieu d'un workflow.
Paramètres clés
- Company ID : requis, et c'est bien l'identifiant Copper, pas le nom de l'entreprise. Si le workflow ne connaît que le nom, lance d'abord Get Many avec le filtre Name et récupère l'identifiant.
Get a company
company.getCe que tu vois dans n8n
Notes & cas d'usage
Lit une seule entreprise et renvoie sa fiche. C'est ainsi qu'un workflow obtient l'état actuel d'un compte, et non celui qu'il avait au déclenchement.
Paramètres clés
- Company ID : requis. Issu du Copper Trigger ou d'une lecture précédente, il se mappe en expression plutôt qu'il ne se tape.
Get many companies
company.getAllCe que tu vois dans n8n
Notes & cas d'usage
Ramène les entreprises en lot. C'est l'opération derrière les exports, les audits et toute revue de comptes récurrente.
Paramètres clés
- Return All : activé, n8n enchaîne les pages de l'API et rapatrie toutes les entreprises. Désactivé, Limit fixe le nombre d'enregistrements renvoyés, ce qui garde les tests courts.
- Filters : Country sélectionne le pays de l'entreprise dans une liste de codes, Name restreint à un nom d'entreprise.
Update a company
company.updateCe que tu vois dans n8n
Notes & cas d'usage
Modifie une entreprise existante. Seuls les champs remplis sont envoyés, le reste de la fiche ne bouge pas.
Paramètres clés
- Company ID : requis, il désigne la fiche à modifier.
- Update Fields : bloc optionnel avec Name, Details, Address et Phone Numbers. À noter, Email Domain n'y figure pas, contrairement à la création.
Customer Source
1 opérationGet many customer sources
customerSource.getAllCe que tu vois dans n8n
Notes & cas d'usage
Renvoie les sources client configurées dans Copper, ces libellés qui disent d'où vient une affaire. C'est la lecture à faire avant d'écrire quoi que ce soit sur une opportunité.
Paramètres clés
- Return All : activé, la liste complète revient, ce qui est en général le bon réflexe vu qu'elle est courte. Désactivé, Limit plafonne le nombre renvoyé.
Lead
5 opérationsCreate a lead
lead.createCe que tu vois dans n8n
Notes & cas d'usage
Écrit un lead dans Copper, l'étape qui précède la qualification en personne et en entreprise.
Paramètres clés
- Name : requis. Tout le reste est optionnel, donc un formulaire incomplet atterrit quand même au lieu d'être perdu.
- Additional Fields : porte Email, Phone Numbers et Address, chacun derrière son propre bouton Add.
Delete a lead
lead.deleteCe que tu vois dans n8n
Notes & cas d'usage
Efface un lead de Copper. Utile justement parce que les leads s'accumulent plus vite que n'importe quel autre objet du CRM.
Paramètres clés
- Lead ID : requis. L'identifiant, jamais le nom du lead, donc un workflow de nettoyage lit avant de supprimer.
Get a lead
lead.getCe que tu vois dans n8n
Notes & cas d'usage
Va chercher un lead et passe sa fiche au nœud suivant. C'est la lecture qu'on glisse entre un déclenchement et une décision.
Paramètres clés
- Lead ID : requis. Le plus souvent une expression comme
{{ $json.field }}qui porte l'identifiant venu de l'étape d'avant.
Get many leads
lead.getAllCe que tu vois dans n8n
Notes & cas d'usage
Récupère des leads par paquets, filtrés ou non. C'est la moitié lecture de tout workflow de scoring ou de nurturing.
Paramètres clés
- Return All : activé pour un export complet, désactivé pour s'arrêter à Limit.
- Filters : ici Country est un champ texte libre, le nom du pays, pas une liste de codes comme sur les entreprises. Name filtre sur le nom du lead.
Update a lead
lead.updateCe que tu vois dans n8n
Notes & cas d'usage
Modifie un lead déjà présent dans Copper, champ par champ, sans réécrire la fiche entière.
Paramètres clés
- Lead ID : requis, la fiche à modifier.
- Update Fields : le plus large des blocs côté lead, avec Name, Details, Email, Phone Numbers et Address. Details accueille très bien une note de scoring ou un résumé d'appel.
Opportunity
5 opérationsCreate an opportunity
opportunity.createCe que tu vois dans n8n
Notes & cas d'usage
Ouvre une affaire dans Copper et la renvoie. C'est le moment où une conversation qualifiée devient une ligne de pipeline.
Paramètres clés
- Name : requis, le nom de l'affaire.
- Primary Contact ID : optionnel, l'identifiant de l'entreprise principale rattachée à l'affaire.
- Customer Source ID : optionnel, l'identifiant de la source qui a généré l'opportunité. À lire d'abord avec Get Many sur les sources client plutôt qu'à écrire en dur.
Delete an opportunity
opportunity.deleteCe que tu vois dans n8n
Notes & cas d'usage
Sort une affaire de Copper. Rarement automatisé pour lui-même, souvent en dernière étape d'une branche de nettoyage.
Paramètres clés
- Opportunity ID : requis. Il vient d'une lecture précédente ou du trigger, jamais du nom de l'affaire.
Get an opportunity
opportunity.getCe que tu vois dans n8n
Notes & cas d'usage
Charge une affaire et renvoie sa fiche actuelle, avec ce qui a changé depuis le dernier passage du workflow.
Paramètres clés
- Opportunity ID : requis, mappé depuis le trigger ou depuis une opération de liste antérieure.
Get many opportunities
opportunity.getAllCe que tu vois dans n8n
Notes & cas d'usage
Renvoie les affaires en lot. Le reporting de pipeline dans n8n commence ici, et tout ce qui doit regarder plus d'une affaire à la fois aussi.
Paramètres clés
- Return All : activé pour parcourir toutes les pages du pipeline, désactivé pour s'arrêter à Limit.
- Filters : Company IDs et Customer Source IDs acceptent des identifiants séparés par des virgules, donc plusieurs comptes ou plusieurs sources tiennent dans un seul appel.
Update an opportunity
opportunity.updateCe que tu vois dans n8n
Notes & cas d'usage
Modifie une affaire sur place. C'est ce qui fait passer un workflow de la lecture du pipeline à son entretien.
Paramètres clés
- Opportunity ID : requis, l'affaire à modifier.
- Update Fields : Name, Primary Contact ID et Customer Source ID. Les deux identifiants permettent de rattacher une affaire à une autre entreprise ou à une autre source sans ouvrir Copper.
Person
5 opérationsCreate a person
person.createCe que tu vois dans n8n
Notes & cas d'usage
Ajoute un contact dans Copper. L'écriture la plus utilisée du nœud, et celle sur laquelle beaucoup de workflows se terminent.
Paramètres clés
- Name : requis, le nom du contact.
- Additional Fields : le bloc optionnel le plus fourni du nœud, avec Emails, Phone Numbers, Address, Email Domain et Details. Emails et Phone Numbers acceptent plusieurs entrées via Add Email et Add Phone Number.
Delete a person
person.deleteCe que tu vois dans n8n
Notes & cas d'usage
Supprime un contact de Copper, sans retour possible. Aucune étape de confirmation, donc mets une condition devant.
Paramètres clés
- Person ID : requis, l'identifiant Copper du contact.
Get a person
person.getCe que tu vois dans n8n
Notes & cas d'usage
Relit un contact et renvoie sa fiche, ce qui en fait la première étape naturelle après tout déclenchement qui ne transmet qu'un identifiant.
Paramètres clés
- Person ID : requis. Une expression du type
{{ $json.field }}est la façon habituelle de le passer depuis le nœud précédent.
Get many people
person.getAllCe que tu vois dans n8n
Notes & cas d'usage
Liste les contacts. C'est la lecture derrière toute synchronisation entre Copper et un outil d'e-mailing ou un tableur.
Paramètres clés
- Return All : activé, tous les contacts remontent page après page. Désactivé, Limit décide combien, ce qui compte sur un carnet d'adresses qui grossit depuis des années.
- Filters : un unique filtre Name, donc le tri se fait sur le nom du contact et rien d'autre.
Update a person
person.updateCe que tu vois dans n8n
Notes & cas d'usage
Réécrit les champs que tu choisis sur un contact existant et laisse les autres tranquilles.
Paramètres clés
- Person ID : requis, le contact à modifier.
- Update Fields : le bloc le plus large du nœud, avec Name, Emails, Phone Numbers, Address, Email Domain et Details. Envoyer le bloc vide ne fait rien, ce qui est une valeur sûre quand une branche hésite.
Project
5 opérationsCreate a project
project.createCe que tu vois dans n8n
Notes & cas d'usage
Un projet naît dans Copper à partir de ce que le workflow vient de produire. Le commercial signe, la fiche de suivi existe déjà quand la production s'y met.
Paramètres clés
- Name : requis, le nom du projet créé. Il vient souvent d'un nœud précédent, sous la forme d'une expression
{{ $json.field }}, c'est-à-dire une référence à un champ de l'item entrant. - Additional Fields : les options posées dès la création. Assignee ID désigne l'utilisateur propriétaire, Details reçoit la description, Status vaut
OpenouCompleted.
Delete a project
project.deleteCe que tu vois dans n8n
Notes & cas d'usage
Le ménage passe par là : l'opération retire un projet de Copper, un identifiant à la fois.
Paramètres clés
- Project ID : requis, l'identifiant du projet à supprimer. Copper attend bien l'identifiant, pas le nom du projet, donc récupère-le d'une étape de lecture plutôt que de le saisir à la main.
Get a project
project.getCe que tu vois dans n8n
Notes & cas d'usage
Il arrive qu'un workflow n'ait qu'un identifiant en main. Cette opération va chercher le projet correspondant dans Copper et remet ses données dans le flux.
Paramètres clés
- Project ID : requis, l'identifiant du projet à récupérer. Il vient en général du trigger, le nœud qui démarre le workflow, ou d'une recherche faite juste avant.
Get many projects
project.getAllCe que tu vois dans n8n
Notes & cas d'usage
Les exports partent d'ici. L'opération récupère la liste des projets de Copper, soit en totalité, soit par lot plafonné.
Paramètres clés
- Return All : activé, n8n enchaîne les pages de l'API jusqu'au dernier projet ; désactivé, Limit fixe le nombre maximal de projets renvoyés.
- Filters : le filtre Name restreint la liste aux projets portant ce nom, ce qui évite de tout ramener pour trier ensuite.
Update a project
project.updateCe que tu vois dans n8n
Notes & cas d'usage
Un projet vit plusieurs semaines et ses informations bougent. L'opération écrit sur un projet déjà présent dans Copper, et seuls les champs renseignés changent.
Paramètres clés
- Project ID : requis, l'identifiant du projet à mettre à jour.
- Update Fields : Name renomme le projet, Details remplace la description, Assignee ID confie le projet à un autre utilisateur, Status le fait passer entre
OpenetCompleted.
Completed quand la dernière facture est encaissée, sans que personne n'ait à rouvrir le CRM le vendredi soir.Task
5 opérationsCreate a task
task.createCe que tu vois dans n8n
Notes & cas d'usage
Une relance oubliée coûte plus cher qu'une tâche mal nommée. Cette opération crée la tâche dans Copper à partir de l'événement qui vient de se produire.
Paramètres clés
- Name : requis, le texte de la tâche, celui que la personne concernée lira dans Copper.
- Additional Fields : Assignee ID pour l'utilisateur propriétaire de la tâche, Details pour la description longue, Priority en
HighouNone, Status enOpenouCompleted.
High.Delete a task
task.deleteCe que tu vois dans n8n
Notes & cas d'usage
Supprimer une tâche de Copper tient en un appel, à condition de lui donner le bon identifiant.
Paramètres clés
- Task ID : requis, l'identifiant de la tâche à supprimer. Il se lit dans l'étape qui a trouvé la tâche, jamais dans son intitulé.
Get a task
task.getCe que tu vois dans n8n
Notes & cas d'usage
Avant d'envoyer quoi que ce soit, il vaut mieux savoir où en est la tâche. L'opération renvoie celle qui correspond à l'identifiant fourni.
Paramètres clés
- Task ID : requis, l'identifiant de la tâche à récupérer, hérité du trigger ou d'une liste lue juste avant.
Get many tasks
task.getAllCe que tu vois dans n8n
Notes & cas d'usage
Pour regarder la charge d'une équipe, il faut d'abord sortir les tâches du CRM. C'est le rôle de cette opération.
Paramètres clés
- Return All : activé, n8n réclame les pages suivantes jusqu'à la dernière tâche ; désactivé, Limit plafonne le nombre de tâches ramenées.
- Filters : Assignee IDs et Project IDs acceptent des identifiants séparés par des virgules, de quoi couvrir une équipe entière ou un seul projet avec un nœud.
Update a task
task.updateCe que tu vois dans n8n
Notes & cas d'usage
Changer la priorité, réaffecter, corriger un intitulé : tout ça passe par la mise à jour d'une tâche déjà enregistrée dans Copper.
Paramètres clés
- Task ID : requis, l'identifiant de la tâche à modifier.
- Update Fields : Assignee ID transfère la tâche à un autre utilisateur, Name et Details réécrivent l'intitulé et la description, Priority accepte
HighouNone, Status accepteOpenouCompleted.
User
1 opérationGet many users
user.getAllCe que tu vois dans n8n
Notes & cas d'usage
Côté humain, Copper connaît les utilisateurs du compte. L'opération en sort la liste, pour le compte auquel donne accès le credential, la connexion enregistrée une fois dans n8n.
Paramètres clés
- Return All : activé, tous les utilisateurs remontent ; désactivé, Limit décide combien le nœud en renvoie par exécution.
Besoin d'aide pour automatiser Copper avec n8n ?
L'équipe te répond directement.
Chaque message est lu par une personne.