Ressources · Intégration n8n

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

Pourquoi automatiser

À 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.

Connexion

Comment connecter ConvertKit à n8n ?

  1. 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.

  2. 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.

  3. 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.

Déclencheurs

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.*2
    subscriber.*2
      tag.*2
        form.*1
          link.*1
            product.*1
              purchase.*1

                Notes de configuration

                01Configure the ConvertKit TriggerLe 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.

                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.
                Quand l'utiliser
                dès que le point de départ appartient à ConvertKit et pas à ton côté, un nouvel abonné, un achat, un tag posé à la main par un collègue.
                02Form Subscribe, Sequence Subscribe and Sequence CompleteTrois é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.

                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 courseSubscribe et courseComplete, sur le même principe.
                Quand l'utiliser
                une séquence terminée est un bon moment pour relancer, et une inscription au formulaire est l'endroit où enrichir la fiche, avant le premier email.
                03Tag Add, Tag Remove, Subscriber Activated and Subscriber UnsubscribeQuatre é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.

                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 tagAdd ou tagRemove, choisi dans la liste chargée ou fourni par une expression.
                Quand l'utiliser
                dans la plupart des comptes ConvertKit, le tag est ce qui encode l'intention. 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 CreatedLes 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.

                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.
                Quand l'utiliser
                un clic sur un lien de tarifs est un signal commercial qui mérite d'atterrir chez un humain, et un achat est le début naturel d'une séquence d'onboarding.
                Actions

                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.

                Matrice ressources × opérations
                RessourceCreateGet ManyUpdateDeleteAddAdd SubscriberGet Subscriptions
                Custom Field✓✓✓✓
                Form✓✓✓
                Sequence✓✓✓
                Tag✓✓
                Tag Subscriber✓✓✓

                Custom Field

                4 opérations
                01

                Create a custom field

                customField.create

                Ce 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é.
                Cas d'usage
                une boutique en ligne crée une fois un champ Last Order Total à l'installation, puis le remplit à chaque commande traitée par le workflow.
                02

                Delete a custom field

                customField.delete

                Ce 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.
                Cas d'usage
                un workflow de ménage trimestriel supprime les champs laissés par un ancien formulaire, une fois la liste validée par un humain.
                03

                Get many custom fields

                customField.getAll

                Ce 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.
                Cas d'usage
                un workflow lit la liste des champs en début d'exécution et ne crée un champ que si le libellé manque vraiment.
                04

                Update a custom field

                customField.update

                Ce 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.
                Cas d'usage
                un champ nommé Source devient Acquisition Source dans tout le compte, en une exécution, plutôt qu'à la main dans l'interface ConvertKit.

                Form

                3 opérations
                05

                Add a subscriber

                form.addSubscriber

                Ce 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.
                Cas d'usage
                une page d'inscription à un webinaire hébergée sur ton domaine envoie ses données à n8n, qui range chaque inscrit dans le formulaire ConvertKit correspondant.
                06

                Get many forms

                form.getAll

                Ce 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.
                Cas d'usage
                un audit mensuel liste tous les formulaires, puis signale ceux qui n'apparaissent plus nulle part sur le site.
                07

                Get all subscriptions

                form.getSubscriptions

                Ce 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 : active ou cancelled, 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.
                Cas d'usage
                un rapport growth compare mois par mois le formulaire de la page tarifs et celui du blog.

                Sequence

                3 opérations
                08

                Add a subscriber

                sequence.addSubscriber

                Ce 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.
                Cas d'usage
                un acheteur entre dans la séquence d'onboarding dès que l'événement d'achat atteint n8n, déjà taggé comme client.
                09

                Get many sequences

                sequence.getAll

                Ce 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.
                Cas d'usage
                un outil interne affiche les séquences du moment dans un menu déroulant, et un collègue en choisit une sans jamais ouvrir ConvertKit.
                10

                Get all subscriptions to a sequence

                sequence.getSubscriptions

                Ce 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 : active pour ceux encore dans le flux, cancelled pour étudier les sorties.
                • Return All : coché pour parcourir toute la séquence ; décoché, Limit plafonne le résultat.
                Cas d'usage
                un export hebdomadaire verse la séquence d'onboarding dans un tableur que l'équipe support surveille déjà.

                Tag

                2 opérations
                11

                Create a tag

                tag.create

                Ce 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.
                Cas d'usage
                le lancement d'un produit crée toute sa panoplie de tags en une exécution, liste d'attente, acheteur et remboursement compris, avant la première campagne.
                12

                Get many tags

                tag.getAll

                Ce 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é.
                Cas d'usage
                avant de créer un tag, un workflow vérifie les noms existants et en réutilise un quand le libellé est assez proche.

                Tag Subscriber

                3 opérations
                13

                Add a tag to a subscriber

                tagSubscriber.add

                Ce 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.
                Cas d'usage
                un ticket support classé en risque de départ tague la personne, et la campagne suivante la laisse de côté.
                14

                Get many tag subscriptions

                tagSubscriber.getAll

                Ce 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 : active ou cancelled, selon que le segment sert à envoyer ou à analyser.
                • Return All : coché pour le segment entier ; décoché, Limit le raccourcit.
                Cas d'usage
                le tag webinaire devient un fichier d'audience pour une régie publicitaire, rafraîchi le matin de la session.
                15

                Delete a tag from a subscriber

                tagSubscriber.delete

                Ce 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.
                Cas d'usage
                un utilisateur en essai qui passe à l'offre payante perd le tag essai dans le workflow qui lui donne le tag client, pour qu'aucune campagne ne le traite comme les deux à la fois.
                Besoin d'aide

                Besoin d'aide pour automatiser ConvertKit avec n8n ?

                L'équipe te répond directement.

                Chaque message est lu par une personne.

                FAQ

                ConvertKit et n8n, les questions qui suivent

                01L'intégration ConvertKit n8n est-elle gratuite ?
                Oui côté n8n. Le nœud ConvertKit et le ConvertKit Trigger sont livrés avec n8n : rien à installer, rien à payer en plus pour le connecteur lui-même. Ça vaut sur n8n Cloud, l'offre hébergée par n8n, comme sur une instance auto-hébergée installée via Docker ou npm, en Community Edition sous licence Sustainable Use. Un workflow se comporte de la même façon des deux côtés, donc rien n'empêche de prototyper sur Cloud puis de déplacer le tout. Ce que coûte le compte ConvertKit lui-même est une autre question, que cette page ne traite pas.
                02Quels identifiants faut-il pour connecter ConvertKit à n8n ?
                Une clé d'API, et rien d'autre. ConvertKit propose l'authentification par clé d'API pour ces deux nœuds, et la clé se trouve dans ton compte, dans les paramètres, section Advanced. Dans n8n, tu crées un credential ConvertKit et tu colles cette valeur dans le champ intitulé API Secret. Le même credential authentifie le nœud ConvertKit et le ConvertKit Trigger, et une fois enregistré il se réutilise dans tous les workflows de l'instance plutôt que d'être ressaisi. Pour vérifier en dix secondes, ouvre un sélecteur Form Name or ID et regarde si tes vrais formulaires apparaissent.
                03Quelles sont les limites du nœud ConvertKit dans n8n ?
                Ça dépend de ce que tu vises au-delà du catalogue. Le nœud expose 15 opérations sur 5 ressources, et tout ce qui sort de cette liste s'atteint avec 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. Deux points comptent davantage au quotidien. Les opérations de lecture renvoient la première page tant que Return All n'est pas activé, Limit fixant sinon le nombre maximal d'items. Et un champ personnalisé doit exister dans le compte avant qu'une opération d'abonné puisse écrire dedans, tandis qu'un champ requis laissé vide bloque l'exécution du nœud.
                04Le ConvertKit Trigger réagit-il en temps réel ?
                Oui, il fonctionne par webhook. À l'activation du workflow, n8n enregistre auprès de ConvertKit une URL de webhook, c'est-à-dire une adresse que ConvertKit appelle à chaque fois que l'événement choisi se produit. L'événement atteint ton workflow en quelques secondes : pas de boucle de polling, pas d'intervalle à régler. Tu choisis l'événement dans le paramètre Event, et selon celui retenu le nœud demande sa portée, un Form Name or ID, un Sequence Name or ID, un Tag Name or ID, un Initiating Link ou un Product ID. Dix événements sont disponibles au total.
                05n8n ou Make pour automatiser ConvertKit ?
                Ça dépend de quatre critères, et aucun des deux ne les gagne tous. L'hébergement d'abord : n8n tourne sur ton propre serveur via Docker ou npm, ou sur n8n Cloud, quand Make existe uniquement en version hébergée. La maîtrise des données en découle, puisqu'une instance auto-hébergée garde les emails des abonnés dans ton infrastructure. Le modèle de coût ensuite : Make facture à l'opération, ce qui mérite une simulation face à un workflow qui boucle sur un export de tag complet. La logique visuelle enfin : les deux sont des éditeurs visuels, et l'outil que ton équipe maintiendra vraiment reste le bon choix. L'avis n8n lié plus haut entre dans le détail.