- Accueil
- Ressources
- Intégrations
- ConvertKit
Intégration ConvertKit n8nAutomatiser ConvertKit avec n8n.
Un abonné bouge dans ConvertKit, un workflow démarre. L'intégration ConvertKit n8n repose sur un nœud de 15 opérations réparties sur 5 ressources, et sur un trigger qui écoute 10 événements. De quoi piloter formulaires, tags et séquences sans passer par un développeur.
Avis vérifiés sur Trustpilot · Agence IA, automatisation & growth
À quoi sert l'intégration ConvertKit n8n ?
Le nœud ConvertKit dialogue avec l'API ConvertKit depuis un workflow n8n. Il couvre 5 ressources, les champs personnalisés, les formulaires, les séquences, les tags et les abonnés taggés, soit 15 opérations au total. À côté, un nœud trigger distinct démarre un workflow sur 10 événements ConvertKit répartis en 7 familles. Les deux lisent la même clé d'API : un seul credential suffit pour la paire.
Le point de départ le plus fréquent tient en une phrase : le formulaire d'inscription vit ailleurs que dans ConvertKit. Sur un site maison, dans un tableur, dans un outil d'événement. Les gens le remplissent et n'arrivent jamais dans la liste email. Un workflow qui lit la nouvelle ligne et appelle form.addSubscriber referme le trou, avec le prénom et les champs personnalisés déjà connus. La ligne peut rester au passage dans Google Sheets pour l'équipe commerciale.
Sortir des données marche aussi bien. sequence.getSubscriptions et tagSubscriber.getAll renvoient les abonnés d'une séquence ou d'un tag, avec leurs données. Return All activé, n8n enchaîne les pages de l'API et ramène la liste complète au lieu de la première page. C'est le chemin d'un segment qui part vers un rapport, vers une plateforme de webinaire, ou vers une seconde base dans ActiveCampaign.
Reste le sens inverse, celui où ConvertKit donne le signal. Le trigger se déclenche sur productPurchase ou sur tagAdd, et tout se joue dans la même exécution : l'acheteur entre dans une séquence d'onboarding via sequence.addSubscriber, un récapitulatif part par Gmail au responsable du compte, un tag marque la fiche pour la campagne suivante. Rien à programmer, rien à vérifier à la main.
Ce qui sort des 15 opérations du catalogue passe par le nœud HTTP Request, qui appelle n'importe quel endpoint de l'API ConvertKit en réutilisant le même credential via l'authentification prédéfinie. C'est la façon normale d'élargir la paire, pas un bricolage. Deux réflexes font gagner du temps : créer le champ personnalisé avant qu'une opération d'abonné tente de le remplir, et se rappeler qu'un champ marqué requis laissé vide bloque l'exécution du nœud.
Tu hésites encore entre plusieurs plateformes d'automatisation ? L'Avis n8n détaille les arbitrages, et la Formation n8n reprend la construction de ce type de workflow du début à la fin.
Comment connecter ConvertKit à n8n ?
- 01
Récupérer la clé d'API dans ConvertKit
Un compte ConvertKit est le seul prérequis. Ouvre les paramètres du compte (Account Settings), va dans la section Advanced, et copie la clé d'API affichée à cet endroit. Cette valeur unique est celle que n8n réclame, et elle sert autant au nœud ConvertKit qu'au ConvertKit Trigger. Il n'y a donc rien d'autre à générer côté ConvertKit avant de commencer à construire.
- 02
Créer le credential ConvertKit dans n8n
Dans n8n, ouvre le menu Credentials et crée un nouveau credential ConvertKit, c'est-à-dire un jeu d'identifiants enregistré une fois pour toutes. Colle la valeur copiée dans le champ nommé API Secret, puis enregistre sous un nom que tu reconnaîtras plus tard. Un credential se réutilise ensuite dans tous les workflows : cette étape ne se refait pas.
- 03
Sélectionner le credential et charger une liste
Pose un nœud ConvertKit sur le canevas et choisis ton credential dans la liste déroulante en haut du nœud. Sélectionne une ressource, puis ouvre le sélecteur Form Name or ID ou Tag Name or ID : si n8n remplit la liste avec tes vrais formulaires et tes vrais tags, la clé fonctionne. Refais la même sélection sur le nœud trigger.
Qu'est-ce qui peut lancer un workflow depuis ConvertKit ?
ConvertKit Trigger est le nœud qui démarre un workflow quand quelque chose se passe dans ConvertKit. Il écoute 10 é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 ConvertKit 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.
course.*2subscriber.*2tag.*2form.*1link.*1product.*1purchase.*1Notes de configuration
01Configure the ConvertKit Trigger
Le ConvertKit Trigger est un nœud à part, qui ouvre le workflow au lieu de le terminer. Tu choisis une valeur dans Event, et à l'activation n8n enregistre un webhook auprès de ConvertKit, c'est-à-dire une URL que ConvertKit appelle à chaque fois que l'événement se produit. L'événement arrive dans n8n en quelques secondes, sans polling et sans intervalle à régler. Le nœud est en version 1 et lit le même credential que le nœud d'action.
Paramètres clés
- Event : l'événement ConvertKit écouté par ce workflow, parmi les 10 disponibles répartis en 7 familles. Un nœud trigger écoute un événement : pour réagir à deux choses différentes, il faut deux nœuds trigger ou deux workflows.
02Form Subscribe, Sequence Subscribe and Sequence Complete
Trois événements suivent le parcours d'un lecteur dans tes contenus. formSubscribe se déclenche quand quelqu'un s'inscrit via un formulaire, courseSubscribe quand un abonné entre dans une séquence, courseComplete quand il arrive au bout. Ensemble, la famille form et la famille course pèsent 3 des 10 événements.
Paramètres clés
- Form Name or ID : le formulaire surveillé pour
formSubscribe. Prends-le dans la liste que n8n charge avec ton credential, ou passe un identifiant par une expression quand il change d'une exécution à l'autre. - Sequence Name or ID : la séquence surveillée pour
courseSubscribeetcourseComplete, sur le même principe.
03Tag Add, Tag Remove, Subscriber Activated and Subscriber Unsubscribe
Quatre événements rapportent ce qui change sur la fiche de l'abonné. tagAdd et tagRemove se déclenchent quand un tag est posé ou retiré, qu'un humain l'ait fait depuis ConvertKit ou qu'une automatisation s'en soit chargée. subscriberActivate et subscriberUnsubscribe marquent les deux bouts de la relation. Soit 4 des 10 événements, sur la famille tag et la famille subscriber.
Paramètres clés
- Tag Name or ID : le tag surveillé par
tagAddoutagRemove, choisi dans la liste chargée ou fourni par une expression.
tagAdd devient alors le passage de relais le plus propre entre un collègue qui clique dans ConvertKit et un workflow qui fait le reste.04Link Click, Product Purchase and Purchase Created
Les trois derniers événements viennent de ce qu'un abonné fait avec un lien ou avec son argent. linkClick se déclenche au clic sur une URL que tu désignes, productPurchase à l'achat d'un produit donné, purchaseCreate à la création d'un achat. Chacun occupe sa propre famille, ce qui explique en partie ces 7 familles pour 10 événements.
Paramètres clés
- Initiating Link : l'URL du lien à l'origine du déclenchement pour
linkClick, saisie en entier plutôt que prise dans une liste. - Product ID : l'identifiant du produit surveillé par
productPurchase, saisi lui aussi comme une valeur.
Que sait faire le nœud ConvertKit dans un workflow ?
Le nœud ConvertKit expose 15 opérations sur 5 ressources. Pour chacune : le nœud tel que tu le configures dans n8n, les champs obligatoires, et nos notes de terrain.
| Ressource | Create | Get Many | Update | Delete | Add | Add Subscriber | Get Subscriptions |
|---|---|---|---|---|---|---|---|
| Custom Field | ✓ | ✓ | ✓ | ✓ | |||
| Form | ✓ | ✓ | ✓ | ||||
| Sequence | ✓ | ✓ | ✓ | ||||
| Tag | ✓ | ✓ | |||||
| Tag Subscriber | ✓ | ✓ | ✓ |
Sommaire des opérations
Custom Field
4 opérationsCreate a custom field
customField.createCe que tu vois dans n8n
Notes & cas d'usage
Les champs personnalisés stockent ce que ConvertKit ne garde pas d'origine : un nom d'offre, une source d'acquisition. Cette opération en crée un dans le compte, pour que les opérations d'abonné aient un endroit où écrire.
Paramètres clés
- Label : le libellé du champ personnalisé, celui que tu retrouveras dans ConvertKit et dans le sélecteur Add Custom Field des opérations d'abonné.
Delete a custom field
customField.deleteCe que tu vois dans n8n
Notes & cas d'usage
Les champs s'accumulent plus vite qu'on ne le croit, et un champ que personne ne remplit rend le compte illisible. Cette opération en supprime un de ConvertKit.
Paramètres clés
- Field ID : l'identifiant du champ personnalisé, pas son libellé. Quand tu ne connais que le libellé, c'est Get many custom fields qui te donne cet identifiant.
Get many custom fields
customField.getAllCe que tu vois dans n8n
Notes & cas d'usage
Liste les champs personnalisés définis dans le compte, avec leur libellé et leur identifiant. C'est l'opération qui transforme un nom de champ que tu connais en identifiant attendu par la mise à jour et la suppression.
Paramètres clés
- Return All : coché, n8n enchaîne les pages de l'API et ramène tous les champs du compte ; décoché, Limit plafonne le nombre de champs renvoyés.
Update a custom field
customField.updateCe que tu vois dans n8n
Notes & cas d'usage
Change le libellé d'un champ qui existe déjà dans ConvertKit. Pratique quand le nom choisi dans l'urgence ne correspond plus à ce que le champ contient.
Paramètres clés
- Field ID : l'identifiant du champ personnalisé à renommer.
- Label : le nouveau libellé du champ personnalisé, celui qui s'affichera ensuite dans ConvertKit.
Form
3 opérationsAdd a subscriber
form.addSubscriberCe que tu vois dans n8n
Notes & cas d'usage
Inscrit une adresse email dans un formulaire ConvertKit, la façon dont quelqu'un rejoint la liste depuis l'extérieur. Le formulaire choisi commande ce qui se passe ensuite côté ConvertKit.
Paramètres clés
- Form Name or ID : le formulaire visé, pris dans la liste chargée par n8n ou fourni comme identifiant via une expression.
- Email : l'adresse email de l'abonné, au format
name@email.com. - First Name et Custom Fields, dans Additional Fields : des paires clé/valeur qui accompagnent l'abonné. Le champ personnalisé doit exister avant d'être utilisé ici.
Get many forms
form.getAllCe que tu vois dans n8n
Notes & cas d'usage
Renvoie les formulaires qui existent dans le compte. Utile quand un workflow doit choisir un formulaire par son nom au moment de l'exécution, au lieu d'en avoir un figé dans le nœud.
Paramètres clés
- Return All : coché pour un inventaire complet des formulaires du compte ; décoché, Limit fixe le nombre maximal de formulaires renvoyés.
Get all subscriptions
form.getSubscriptionsCe que tu vois dans n8n
Notes & cas d'usage
Liste les inscriptions à un formulaire, avec les données de l'abonné attachées à chacune. C'est la vue acquisition : qui est entré par ce formulaire précis.
Paramètres clés
- Form Name or ID : le formulaire dont tu veux lire les inscriptions.
- Subscriber State, dans Additional Fields :
activeoucancelled, pour séparer ceux qui sont restés de ceux qui sont partis. - Return All : coché pour tout l'historique du formulaire ; décoché, Limit arrête la récupération plus tôt.
Sequence
3 opérationsAdd a subscriber
sequence.addSubscriberCe que tu vois dans n8n
Notes & cas d'usage
Place directement quelqu'un dans une séquence : les emails partent dans l'ordre configuré côté ConvertKit. Contrairement au passage par un formulaire, la cible ici est la série automatisée elle-même.
Paramètres clés
- Sequence Name or ID : la séquence dans laquelle inscrire la personne.
- Email : l'adresse email de l'abonné, au format
name@email.com. - Tag Names or IDs, First Name et Custom Fields, dans Additional Fields : des tags et des valeurs posés au même moment, ce qui évite une seconde opération derrière.
Get many sequences
sequence.getAllCe que tu vois dans n8n
Notes & cas d'usage
Relit les séquences configurées dans le compte, avec l'identifiant de chacune. C'est le contrôle à faire avant qu'un workflow tente d'inscrire qui que ce soit, pour qu'une séquence renommée ne casse pas la suite.
Paramètres clés
- Return All : coché pour lister toutes les séquences ; décoché, Limit décide combien reviennent.
Get all subscriptions to a sequence
sequence.getSubscriptionsCe que tu vois dans n8n
Notes & cas d'usage
Renvoie tous les abonnés d'une séquence donnée, données de l'abonné comprises. Là où la version formulaire répond à « par où sont-ils arrivés », celle-ci répond à « qui est en train de dérouler la série ».
Paramètres clés
- Sequence Name or ID : la séquence à lire.
- Subscriber State, dans Additional Fields :
activepour ceux encore dans le flux,cancelledpour étudier les sorties. - Return All : coché pour parcourir toute la séquence ; décoché, Limit plafonne le résultat.
Tag
2 opérationsCreate a tag
tag.createCe que tu vois dans n8n
Notes & cas d'usage
Ajoute un tag au compte ConvertKit pour que des abonnés puissent le porter ensuite. Créer le tag et le poser sont deux étapes distinctes ici.
Paramètres clés
- Name : le nom du tag. Plusieurs tags se créent d'un coup en séparant les noms par une virgule.
Get many tags
tag.getAllCe que tu vois dans n8n
Notes & cas d'usage
Ramène les tags qui existent dans le compte. La plupart des équipes s'en servent pour éviter un quasi-doublon, parce qu'un compte ConvertKit finit toujours par contenir trois orthographes de la même idée.
Paramètres clés
- Return All : coché pour récupérer la liste complète des tags ; décoché, Limit fixe le nombre maximal renvoyé.
Tag Subscriber
3 opérationsAdd a tag to a subscriber
tagSubscriber.addCe que tu vois dans n8n
Notes & cas d'usage
Applique un tag existant à une personne, identifiée par son adresse email. C'est la brique de segmentation : derrière, une grande partie de la logique ConvertKit s'appuie sur les tags.
Paramètres clés
- Tag Name or ID : le tag à poser, depuis la liste chargée ou via une expression.
- Email : l'adresse email de l'abonné, au format
name@email.com. - First Name et Custom Fields, dans Additional Fields : des valeurs écrites sur l'abonné au même moment, le champ personnalisé ayant été créé avant.
Get many tag subscriptions
tagSubscriber.getAllCe que tu vois dans n8n
Notes & cas d'usage
Liste les abonnements à un tag, avec les données de l'abonné derrière chacun. En pratique, c'est ainsi qu'un segment devient une liste concrète de personnes exploitable hors de ConvertKit.
Paramètres clés
- Tag Name or ID : le tag dont tu veux les abonnés.
- Subscriber State, dans Additional Fields :
activeoucancelled, selon que le segment sert à envoyer ou à analyser. - Return All : coché pour le segment entier ; décoché, Limit le raccourcit.
Delete a tag from a subscriber
tagSubscriber.deleteCe que tu vois dans n8n
Notes & cas d'usage
Retire un tag d'un seul abonné sans toucher au tag lui-même, qui reste disponible pour tous les autres contacts du compte.
Paramètres clés
- Tag Name or ID : le tag à retirer de cette personne.
- Email : l'adresse email de l'abonné, au format
name@email.com.
Besoin d'aide pour automatiser ConvertKit avec n8n ?
L'équipe te répond directement.
Chaque message est lu par une personne.

