Intégration Affinity n8nAutomatiser Affinity avec n8n.
L'intégration Affinity n8n fait sortir tes relations du CRM pour les mettre dans un workflow. Le nœud couvre 16 opérations réparties sur 4 ressources : listes, entrées de liste, organisations et personnes. Le trigger, le nœud qui démarre un workflow, écoute 25 événements en 9 familles.
Avis vérifiés sur Trustpilot · Agence IA, automatisation & growth
À quoi sert l'intégration Affinity n8n ?
Affinity garde la mémoire relationnelle d'une équipe commerciale ou d'investissement. Le nœud n8n va chercher cette matière via l'API Affinity : 16 opérations sur 4 ressources, les listes, les entrées de liste, les organisations et les personnes. Le trigger Affinity assure le sens inverse, avec 25 événements classés en 9 familles, pour qu'un changement fait dans Affinity déclenche un traitement au lieu d'attendre qu'on le remarque.
Tout commence souvent par une entrée de matière : un cabinet de conseil reçoit une demande par formulaire, le workflow crée l'organisation avec organization.create, puis la pose dans la liste de suivi avec listEntry.create. Le deuxième nœud a besoin de l'identifiant renvoyé par le premier : il circule dans une expression, une petite formule notée {{ $json.id }} qui va lire un champ de l'élément entrant.
Dans l'autre sens, c'est le trigger qui prévient que quelque chose a bougé. Il part sur opportunity.updated ou list_entry.created, le workflow recharge la fiche complète, et l'information arrive là où l'équipe regarde vraiment. Un résumé quotidien par Gmail convient aux associés qui vivent dans leur boîte mail, un message instantané convient mieux à une équipe terrain.
Le reporting et la synchro tournent sur un rythme plus lent mais touchent davantage de fiches d'un coup : person.getAll et organization.getAll, Return All activé, déversent le carnet d'adresses dans Google Sheets pour le point mensuel, ou le confrontent aux fiches tenues dans Pipedrive quand deux outils coexistent le temps d'une migration.
Deux points à connaître avant de construire. Return All enchaîne les pages de l'API jusqu'au dernier élément ; laissé désactivé, Limit fixe le nombre maximal d'items renvoyés, ce qui est parfait pour un test et faux pour un export. Et si un endpoint de l'API Affinity ne figure pas dans ces 16 opérations, le nœud HTTP Request l'appelle directement en réutilisant le même credential Affinity par son authentification prédéfinie. Un nœud de plus, rien à reconfigurer.
Si c'est n8n qui est la partie floue, l'Avis n8n dit ce que la plateforme fait bien, et la Formation n8n sert à ceux qui préfèrent apprendre la logique avant de brancher leur CRM.
Comment connecter Affinity à n8n ?
- 01
Vérifier l'abonnement Affinity
L'accès API dépend du plan. La documentation des credentials n8n l'écrit noir sur blanc : il faut un compte Affinity sur un palier Scale, Advanced ou Enterprise pour que la clé existe. Ça se vérifie avec la personne qui gère l'abonnement, avant d'écrire la moindre ligne de workflow, parce qu'aucun réglage n8n ne compense un plan qui ne donne pas accès à l'API.
- 02
Récupérer la clé API dans Affinity
Affinity génère la clé depuis ses propres réglages, et l'article d'aide
360032633992indique où la trouver. Copie la valeur une fois et garde-la au chaud. Le nœud Affinity et le trigger Affinity s'authentifient tous les deux avec cette même clé : il n'y a rien d'autre à collecter côté Affinity. - 03
Créer le credential dans n8n
Dans n8n, ouvre le menu Credentials et crée un credential Affinity, c'est-à-dire un jeu d'identifiants enregistré une fois et réutilisable dans tous les workflows. Colle la valeur dans le champ API Key, enregistre. Ensuite, chaque nœud Affinity propose ce credential dans sa liste déroulante, et la clé n'a plus jamais à être recopiée dans un nœud.
Qu'est-ce qui déclenche un workflow depuis Affinity ?
Affinity Trigger est le nœud qui démarre un workflow quand quelque chose se passe dans Affinity. Il écoute 25 é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 Affinity 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.
field.*3field.createddeletedupdated
field_value.*3field_value. createddeletedupdated
list.*3list.createddeletedupdated
note.*3note.createddeletedupdated
opportunity.*3opportunity.createddeletedupdated
organization.*3organization.createddeletedupdated
person.*3person.createddeletedupdated
file.*2file.createddeleted
list_entry.*2list_entry. createddeleted
Notes de configuration
01Set up the Affinity Trigger
Le trigger Affinity, version 1 du nœud, transforme une activité dans Affinity en exécution de workflow. Il fonctionne par webhook : à l'activation du workflow, n8n enregistre une URL auprès d'Affinity, et Affinity appelle cette URL dès qu'il se passe quelque chose. L'événement arrive dans le workflow en quelques secondes, sans fréquence à régler et sans rien qui tourne en boucle pour vérifier.
Paramètres clés
- Events : les événements auxquels ce workflow s'abonne, à choisir parmi les 25 disponibles. Il n'existe pas de valeur fourre-tout, donc chaque événement utile se coche nommément. En cocher plusieurs ne pose pas de problème, l'élément reçu indique lequel a déclenché.
02Person, organization and opportunity events
Trois familles couvrent les fiches qu'une équipe touche tous les jours, soit 9 événements. person.created, person.updated et person.deleted suivent les contacts. organization.created, organization.updated et organization.deleted suivent les entreprises. opportunity.created, opportunity.updated et opportunity.deleted suivent les affaires elles-mêmes.
Paramètres clés
- Events : coche les trois valeurs opportunity seules pour surveiller le pipeline, ou associe les valeurs created de person et organization quand l'objectif est d'attraper tout ce qui entre dans le CRM.
03List and list entry events
Les listes structurent le travail dans Affinity, et 5 événements sur 2 familles en rendent compte. list.created, list.updated et list.deleted portent sur la liste elle-même, son existence et ses réglages. list_entry.created et list_entry.deleted portent sur l'appartenance, donc sur une fiche qui entre dans une liste ou qui en sort.
Paramètres clés
- Events : la paire list entry est la plus utile pour automatiser un pipeline, puisque déplacer une entreprise d'une liste à l'autre correspond souvent à un changement d'étape.
list_entry.created comme une entrée d'étape et lance la checklist associée. Combine-le avec listEntry.get : l'événement dit qu'il s'est passé quelque chose, l'opération dit quoi. Dans l'autre sens, une entrée retirée d'une liste peut refermer automatiquement la tâche de suivi restée ouverte dans l'outil de gestion de projet de l'équipe.04Field, note and file events
Les 4 familles restantes, 11 événements, concernent le contenu accroché aux fiches plutôt que les fiches. field.created, field.updated et field.deleted portent sur la structure, une colonne ajoutée ou renommée. field_value.created, field_value.updated et field_value.deleted portent sur ce que quelqu'un a réellement saisi. note.created, note.updated et note.deleted suivent les notes écrites, file.created et file.deleted suivent les pièces jointes.
Paramètres clés
- Events : les événements field value sont bruyants sur une équipe active. Mieux vaut leur consacrer un workflow dédié plutôt que de les mélanger à des familles plus calmes.
note.created fait donc un bon point d'accroche pour un compte rendu envoyé à ceux qui n'y étaient pas. Les fichiers, eux, se prêtent bien à un archivage automatique.Que sait faire le nœud Affinity ?
Le nœud Affinity expose 16 opérations sur 4 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 |
|---|---|---|---|---|---|
| List | ✓ | ✓ | |||
| List Entry | ✓ | ✓ | ✓ | ✓ | |
| Organization | ✓ | ✓ | ✓ | ✓ | ✓ |
| Person | ✓ | ✓ | ✓ | ✓ | ✓ |
List
2 opérationsGet a list
list.getCe que tu vois dans n8n
Notes & cas d'usage
Renvoie une liste Affinity et ses informations, ce qui permet à un workflow de vérifier qu'il vise la bonne liste avant d'y écrire quoi que ce soit.
Paramètres clés
- List ID : l'identifiant unique de la liste à récupérer. Fige-le pour une liste toujours identique, ou passe
{{ $json.listId }}quand un nœud précédent a choisi laquelle.
Get many lists
list.getAllCe que tu vois dans n8n
Notes & cas d'usage
Récupère les listes du compte, un élément par liste, ce qui donne au workflow la correspondance entre un nom de liste et son identifiant.
Paramètres clés
- Return All : activé, n8n demande les pages suivantes jusqu'à la dernière liste. Désactivé, Limit fixe combien de listes le nœud renvoie.
List Entry
4 opérationsCreate a list entry
listEntry.createCe que tu vois dans n8n
Notes & cas d'usage
Ajoute une personne, une organisation ou une opportunité existante à une liste. C'est l'opération qui fait réellement entrer une fiche dans un pipeline.
Paramètres clés
- List Name or ID : choisis la liste cible dans le menu que n8n charge depuis le compte, ou passe un identifiant via une expression.
- Entity ID : l'identifiant unique de l'entité (personne, organisation ou opportunité) à ajouter, souvent
{{ $json.id }}issu du nœud qui vient de la créer. - Creator ID : une personne ayant accès à Affinity, enregistrée comme auteur de l'ajout. Vide, c'est le propriétaire de la clé API.
Delete a list entry
listEntry.deleteCe que tu vois dans n8n
Notes & cas d'usage
Retire une entrée d'une liste. La personne ou l'organisation reste dans Affinity, seule son appartenance à cette liste disparaît.
Paramètres clés
- List Name or ID : la liste qui contient l'entrée, choisie dans le menu ou passée comme identifiant.
- List Entry ID : l'identifiant unique de l'entrée à supprimer, qui n'est pas celui de l'entreprise ni de la personne.
Get a list entry
listEntry.getCe que tu vois dans n8n
Notes & cas d'usage
Va chercher une entrée précise et renvoie ce qu'Affinity en garde, plutôt que de parcourir toute la liste pour la retrouver.
Paramètres clés
- List Name or ID : la liste qui contient l'entrée visée.
- List Entry ID : l'identifiant unique de l'entrée à récupérer.
list_entry.created, cette opération transforme la référence en fiche complète, et le workflow a enfin de quoi rédiger un message utile.Get many list entries
listEntry.getAllCe que tu vois dans n8n
Notes & cas d'usage
Parcourt une liste et en renvoie les entrées comme autant d'éléments distincts, prêts pour une boucle ou une écriture groupée.
Paramètres clés
- List Name or ID : la liste dont les entrées doivent être récupérées.
- Return All : activé pour un export complet. Désactivé, Limit plafonne le nombre d'entrées renvoyées, ce qui convient pendant les tests.
Organization
5 opérationsCreate an organization
organization.createCe que tu vois dans n8n
Notes & cas d'usage
Crée une entreprise dans Affinity et la renvoie avec son identifiant, la valeur dont auront besoin toutes les opérations suivantes sur cette entreprise.
Paramètres clés
- Name : le nom de l'organisation.
- Domain : son nom de domaine, et le champ à normaliser en amont, puisqu'un préfixe qui traîne crée un doublon au lieu d'un rapprochement.
- Person Names or IDs : les personnes associées à la nouvelle organisation, choisies dans la liste ou passées par identifiants.
476 fait exactement ça, créer une organisation dans Affinity à partir de ce que le workflow a reçu.Delete an organization
organization.deleteCe que tu vois dans n8n
Notes & cas d'usage
Supprime la fiche d'une entreprise dans Affinity. Tout ce que l'équipe y avait rattaché part avec elle, donc cette opération se place plutôt derrière une condition que seule au fil de l'eau.
Paramètres clés
- Organization ID : l'identifiant unique de l'organisation, pas son nom et pas son domaine.
Get an organization
organization.getCe que tu vois dans n8n
Notes & cas d'usage
Lit une entreprise par son identifiant et renvoie sa fiche, avec une option qui change la quantité de contexte renvoyée.
Paramètres clés
- Organization ID : l'identifiant unique de l'organisation.
- With Interaction Dates : activé, les dates d'interaction figurent dans la ressource renvoyée, ce qui permet au workflow de raisonner sur le temps écoulé depuis le dernier contact.
Get many organizations
organization.getAllCe que tu vois dans n8n
Notes & cas d'usage
Cherche du côté entreprises du carnet d'adresses et renvoie un élément par organisation trouvée.
Paramètres clés
- Term : une chaîne qui cherche dans toutes les organisations du carnet d'adresses de l'équipe, par exemple une adresse email, un prénom ou un nom.
- Return All : activé pour tout ramener, désactivé pour s'arrêter à Limit.
- With Interaction Dates : ajoute les dates d'interaction à chaque organisation renvoyée.
Update an organization
organization.updateCe que tu vois dans n8n
Notes & cas d'usage
Met à jour une entreprise déjà présente. Seuls les champs remplis sont envoyés, donc un workflow corrige un détail sans toucher au reste de la fiche.
Paramètres clés
- Organization ID : l'identifiant unique de l'organisation à modifier.
- Name et Domain : le nouveau nom et le nouveau domaine quand l'un des deux change.
- Person Names or IDs : les personnes associées à l'organisation.
Person
5 opérationsCreate a person
person.createCe que tu vois dans n8n
Notes & cas d'usage
Enregistre un nouveau contact dans Affinity et renvoie la fiche créée, prête à être rattachée à une liste ou à une entreprise.
Paramètres clés
- First Name et Last Name : les deux sont requis, et bloquants, puisqu'un champ requis laissé vide empêche le nœud de s'exécuter.
- Emails : les adresses email de la personne, au format
info@example.com. - Organization Names or IDs : les organisations auxquelles la personne est associée.
Delete a person
person.deleteCe que tu vois dans n8n
Notes & cas d'usage
Efface un contact d'Affinity à partir de son identifiant. Opération courte, effet définitif : elle se place en bout de branche, après une vérification.
Paramètres clés
- Person ID : l'identifiant unique de la personne, renvoyé par une lecture ou porté par un événement du trigger.
Get a person
person.getCe que tu vois dans n8n
Notes & cas d'usage
Rapporte un contact et ce qu'Affinity sait de lui, dans un élément unique que le nœud suivant lit champ par champ.
Paramètres clés
- Person ID : l'identifiant unique de la personne.
- With Interaction Dates : activé, les dates d'interaction reviennent avec la fiche, ce qui sépare « le contact existe » de « quelqu'un lui a parlé ».
person.updated arrive avec peu de détail, cette opération charge l'état courant avant que le workflow ne décide quoi que ce soit.Get many people
person.getAllCe que tu vois dans n8n
Notes & cas d'usage
Balaie le côté contacts du carnet d'adresses et renvoie un élément par personne, point de départ de tout export ou de tout audit.
Paramètres clés
- Term : une chaîne qui cherche dans toutes les personnes du carnet d'adresses de l'équipe, par exemple une adresse email, un prénom ou un nom.
- Return All : activé pour enchaîner les pages jusqu'au bout, désactivé pour s'arrêter à Limit.
- With Interaction Dates : ajoute les dates d'interaction à chaque personne renvoyée.
Update a person
person.updateCe que tu vois dans n8n
Notes & cas d'usage
Corrige un contact existant. Ce qui reste vide n'est pas touché dans Affinity, ce qui rend l'opération sûre à faire tourner régulièrement contre une source de référence.
Paramètres clés
- Person ID : l'identifiant unique de la personne à modifier.
- Emails : les adresses email de la personne, pratique quand elle change d'employeur.
- First Name, Last Name et Organization Names or IDs : les champs d'identité et de rattachement, mis à jour seulement s'ils sont fournis.
Besoin d'aide pour automatiser Affinity avec n8n ?
L'équipe te répond directement.
Chaque message est lu par une personne.
