Automatise Iterable avec n8n : 6 opérations, 3 ressources

Pourquoi automatiser

Que couvre l'intégration Iterable n8n ?

Le nœud Iterable est livré avec n8n et parle à l'API Iterable avec une clé d'API. Il expose 6 opérations réparties sur 3 ressources : Event, User et User List. Concrètement, il enregistre ce qu'une personne a fait, crée ou rafraîchit son profil, le relit, et la fait entrer ou sortir d'une liste. Ce que le catalogue plus bas ne liste pas passe par le nœud HTTP Request, avec le même credential.

Le besoin le plus fréquent ne commence pas par une inscription, mais par une demande de suppression. Un ticket arrive, user.get vérifie que le profil existe, userList.remove le sort de la liste concernée, user.delete termine le travail. Un seul flux, tracé, sans passer par l'interface Iterable.

Vient ensuite le suivi des actions. Un achat, un rendez-vous pris, un abonnement changé : event.track enregistre l'action sous le nom que tu choisis, et les Data Fields transportent le détail. Le même flux prévient l'équipe sur Slack au passage.

Reste l'entrée en base. Une ligne de Google Sheets ou un formulaire déclenche user.upsert, puis userList.add place la personne sur la bonne liste. Les équipes qui gardent un second outil d'envoi comme SendGrid branchent souvent les deux sur la même sortie.

Au-delà de ces 6 opérations, un objet personnalisé propre à ton compte Iterable ou un endpoint que le nœud ne couvre pas restent accessibles autrement. C'est le rôle du nœud HTTP Request : il atteint n'importe quel endpoint de l'API Iterable et réutilise le credential déjà enregistré grâce à l'authentification prédéfinie, si bien qu'aucune seconde clé ne s'ajoute au workflow. Il suffit d'un nœud de plus, pas d'un nouveau compte.

Le déclenchement suit une autre logique. Comme Iterable n'a pas de nœud trigger dans n8n, le premier nœud du workflow n'est jamais le sien. Un Schedule Trigger vérifie à intervalle fixe, un Webhook attend qu'un service tiers appelle une URL fournie par n8n, ou le trigger d'un tout autre outil démarre l'exécution : un formulaire, un paiement, une inscription. Quel que soit le point de départ choisi, le nœud Iterable ne lit ou n'écrit qu'une fois le workflow déjà lancé, et la Formation n8n détaille ces options de déclenchement avant de choisir.

Connexion

Comment connecter Iterable à n8n ?

01
Générer la clé d'API dans Iterable
Le nœud s'authentifie avec une clé d'API, et c'est la seule méthode prise en charge ici. Tu la crées depuis ton compte Iterable, en suivant leur article consacré à la création des clés d'API (article de support 360043464871). Copie la valeur dès qu'elle s'affiche : c'est elle que n8n envoie à chaque appel. Rien d'autre à préparer côté Iterable.
02
Enregistrer le credential dans n8n
Dans n8n, ouvre le menu Credentials et ajoute un credential Iterable. Il demande un seul champ, API Key, et la valeur se colle là. Un credential se crée une fois et se réutilise partout : le nœud Iterable te le propose ensuite dans une liste déroulante, dans ce workflow comme dans les dix suivants. Nomme-le d'après le compte, ça évitera l'hésitation le jour où un deuxième projet arrive.
03
Valider par une lecture
Pose le nœud Iterable dans un workflow, choisis la ressource User et l'opération Get, mets By sur Email et colle une adresse dont tu es sûr. Exécute ce seul nœud. Le profil revient, le credential est validé avant la moindre écriture. Iterable publie deux références d'API, une pour les projets basés aux États-Unis et une pour ceux basés en Europe : lis celle qui correspond à ton compte.

Actions

Que sait faire le nœud Iterable ?

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

Matrice ressources × opérations
Ressource	Get	Delete	Add	Remove	Track	Create or Update
Event					✓
User	✓	✓				✓
User List			✓	✓

Event

1 opération

01

Track an event

event.track

Ce que tu vois dans n8n

Notes & cas d'usage

Enregistre dans Iterable une action réalisée par un utilisateur, sous le nom que tu lui donnes.

Paramètres clés

Name : le nom de l'événement, requis, et l'étiquette que tu chercheras ensuite dans Iterable.
Email ou User ID : l'un des deux doit être transmis pour identifier la personne, et Email l'emporte si les deux sont envoyés.
Created At : l'heure à laquelle l'événement s'est produit, pratique quand le flux tourne après coup.
ID : identifiant d'événement optionnel. S'il existe déjà un événement avec cet ID, il est mis à jour ; sinon un ID est généré et renvoyé.

Cas d'usage

une commande validée envoie un événement unique, le détail du panier logé dans les Data Fields.

User

3 opérations

02

Create or update a user

user.upsert

Ce que tu vois dans n8n

Notes & cas d'usage

Écrit un profil dans Iterable et le met à jour s'il existe déjà. Le même nœud gère la première rencontre et toutes les mises à jour qui suivent.

Paramètres clés

Identifier : Email ou User ID, la clé sur laquelle Iterable fait la correspondance.
Value : l'adresse ou l'identifiant lui-même, souvent {{ $json.field }} repris du nœud précédent.
Create If Doesn't Exist : indique s'il faut créer un utilisateur quand l'identifiant n'existe pas.
Merge Nested Objects : fusionne les objets de premier niveau au lieu de les écraser, désactivé par défaut.

Cas d'usage

une synchro nocturne pousse l'offre et la langue dans les Data Fields sans aplatir ce qui est déjà stocké.

03

Delete a user

user.delete

Ce que tu vois dans n8n

Notes & cas d'usage

Supprime le profil d'Iterable. L'appel est définitif, il se place donc en bout de branche, pas au milieu.

Paramètres clés

By : Email ou User ID, l'identifiant sur lequel porte la suppression.
User ID : l'identifiant unique d'un utilisateur donné.
Email : l'adresse d'un utilisateur donné.

Cas d'usage

une demande d'effacement arrive sous forme de ticket, le flux supprime le profil puis écrit la confirmation dans le ticket, ce qui garde la trace au même endroit.

04

Get a user

user.get

Ce que tu vois dans n8n

Notes & cas d'usage

Relit un profil depuis Iterable et le transmet à la suite du workflow. C'est comme ça qu'on vérifie qu'une personne existe avant d'agir sur elle.

Paramètres clés

By : choisis si la recherche se fait sur Email ou sur User ID.
User ID : l'identifiant unique d'un utilisateur précis.
Email : l'adresse d'un utilisateur précis.

Cas d'usage

avant qu'une réponse type ne parte au support, le flux relit le profil et oriente le ticket selon ce qui revient, accessible plus loin avec {{ $json.field }}.

User List

2 opérations

05

Add a user to a list

userList.add

Ce que tu vois dans n8n

Notes & cas d'usage

Place une personne sur une liste Iterable. C'est l'étape qui transforme un profil tout neuf en destinataire réel.

Paramètres clés

List Name or ID : choisis la liste dans le menu déroulant, ou passe un ID avec une expression, la petite formule {{ }} que n8n évalue pendant l'exécution, quand la liste se décide en cours de route.
Identifier : Email ou User ID, la façon dont Iterable retrouve la personne.
Value : l'adresse ou l'identifiant correspondant.

Cas d'usage

une inscription à un webinaire arrive, l'inscrit rejoint la liste de rappel juste après l'écriture du profil.

06

Remove a user from a list

userList.remove

Ce que tu vois dans n8n

Notes & cas d'usage

Sort une personne d'une liste Iterable donnée, et sait aller plus loin que cette seule liste.

Paramètres clés

List Name or ID : la liste dont on retire la personne, prise dans le menu ou fixée par expression.
Identifier et Value : Email ou User ID, puis la valeur qui correspond.
Channel Unsubscribe : désabonne l'email du canal associé à la liste, ce qui revient à un désabonnement global.
Campaign ID : rattache ce désabonnement à une campagne.

Cas d'usage

un changement de préférences remonte du site, le flux retire la personne de la liste et garde le rattachement à la campagne.

Besoin d'aide

Besoin d'aide pour automatiser Iterable avec n8n ?

L'équipe te répond directement.

Chaque message est lu par une personne.

FAQ

Iterable et n8n, les questions qui suivent

01L'intégration Iterable n8n est-elle gratuite ?

Oui, côté n8n. Le nœud Iterable est livré avec n8n : rien à installer, aucun coût supplémentaire pour le connecteur lui-même, sur n8n Cloud, l'offre hébergée par n8n, comme sur une instance que tu héberges toi-même (Community Edition, licence Sustainable Use). Un workflow se comporte de la même façon des deux côtés, donc un flux monté sur Cloud se rejoue tel quel sur ton serveur. Ce que coûte un compte Iterable relève d'une autre discussion, et cette page ne s'avance pas dessus.

02Quels identifiants faut-il pour le nœud Iterable ?

Une clé d'API, c'est la seule méthode d'authentification prise en charge. Tu la crées dans Iterable en suivant leur article sur la création des clés d'API, puis tu l'enregistres dans n8n : menu Credentials, credential Iterable, un seul champ API Key. Un credential, c'est un jeu d'identifiants stocké une fois et réutilisé par tous les workflows depuis une liste déroulante, donc la clé n'est jamais collée dans un nœud. Iterable publie deux références d'API, une pour les projets basés aux États-Unis, une pour ceux basés en Europe : lis celle qui correspond à ton compte quand tu cherches le détail d'un endpoint.

03Quelles sont les limites du nœud Iterable dans n8n ?

Le nœud couvre les 6 opérations du catalogue, réparties sur 3 ressources : Event, User et User List. Ce qui sort de ces opérations dans l'API Iterable passe par le nœud HTTP Request, qui appelle l'endpoint directement en réutilisant le même credential Iterable via l'authentification prédéfinie, donc pas de seconde clé à gérer. Deuxième point de vigilance, les champs requis. Une expression qui ne renvoie rien laisse le champ vide, et n8n arrête le nœud au lieu d'envoyer un appel incomplet. Teste sur un item avant de lancer un lot entier.

04Peut-on déclencher un workflow depuis Iterable ?

Non, Iterable n'a pas de nœud trigger dans n8n. Le départ vient d'ailleurs. Le Schedule Trigger lance le flux à intervalle fixe, ce qui convient à une synchronisation de nuit qui rafraîchit les profils ou l'appartenance aux listes. Le Webhook n8n, c'est-à-dire une URL que ton application ou ton prestataire de formulaires appelle au moment où il se passe quelque chose, convient quand la source sait prévenir. Le trigger d'un autre outil marche aussi, et c'est le choix habituel quand la donnée de référence vit dans un CRM ou un tableur. Le nœud Iterable agit alors comme une action dans ce flux.

05n8n ou Make pour Iterable ?

Ça dépend de l'endroit où tu veux que l'automatisation tourne. Make est hébergé chez Make, sans option d'auto-hébergement, et facturé à l'opération : le coût suit le volume et les données transitent par leur plateforme. n8n tourne sur Cloud ou sur ton propre serveur, ce qui compte quand les profils et les événements poussés vers Iterable tombent sous une politique interne de traitement des données. Sur la logique, les deux se construisent visuellement. n8n laisse écrire du code au milieu d'un flux quand une transformation devient spécifique, Make garde le cadre de ses modules. À faible volume et sans contrainte d'hébergement, les deux font le travail.

Générer la clé d'API dans Iterable

Enregistrer le credential dans n8n

Valider par une lecture

Besoin d'aide pour automatiser Iterable avec n8n ?