Ressources · Intégration n8n

Intégration Wekan n8nAutomatiser Wekan avec n8n.

Un tableau Wekan ne devrait jamais se remplir à la main. L'intégration Wekan n8n ouvre 6 ressources et 24 opérations, de la création du tableau jusqu'à la case cochée dans une checklist. Wekan n'a pas de nœud trigger : c'est un autre déclencheur qui lance le workflow.

Avis vérifiés sur Trustpilot · Agence IA, automatisation & growth

Pourquoi automatiser

À quoi sert l'intégration Wekan n8n ?

Le nœud Wekan est livré avec n8n et parle à l'API REST de l'instance Wekan que tu héberges. Il couvre 6 ressources, tableau, liste, carte, commentaire de carte, checklist et élément de checklist, à travers 24 opérations. Un même workflow peut ouvrir un tableau, y poser ses colonnes et ses cartes, commenter ces cartes, puis cocher les éléments de checklist des semaines plus tard. L'authentification passe par un basic auth sur le domaine où répond Wekan.

Le premier usage, c'est le tableau qui se monte tout seul. board.create l'ouvre, list.create ajoute les colonnes de ton process, card.create y dépose les premières cartes. Le template public 728 enchaîne exactement ces trois temps. Pour un bureau d'études qui ouvre un tableau par chantier, ça remplace la duplication manuelle d'un modèle, avec la même structure à chaque fois.

Deuxième usage, la lecture. card.getAll ramène les cartes d'une colonne et la suite du workflow en fait ce qu'elle veut : un état d'avancement déposé dans Notion pour la réunion du lundi, un récapitulatif envoyé par Gmail au client, ou une synchro des statuts vers ClickUp quand une partie de l'équipe travaille ailleurs. Active Return All si la colonne est chargée, sinon n8n s'arrête à Limit.

Troisième usage, le suivi fin. Une carte par recrutement, une checklist par étape, et un workflow qui coche les lignes au fur et à mesure que les outils RH confirment. checklist.create accepte son champ Items dès la création : toute la liste arrive en un appel au lieu d'un appel par ligne.

Le nœud HTTP Request prend le relais dès qu'un endpoint de l'API Wekan sort de ces 24 opérations. Il réutilise le même credential via l'authentification prédéfinie, tu ne ressaisis rien. Deux limites à connaître avant de construire. Les opérations travaillent sur des identifiants Wekan, jamais sur des titres, d'où ces listes déroulantes qui acceptent aussi une expression. Et le chargement des listes, celle des auteurs en particulier, réclame des permissions admin sur le compte Wekan du credential.

Dernière limite, structurelle : pas de nœud trigger Wekan. Un Schedule Trigger à intervalle fixe ou un Webhook n8n appelé par un service tiers ouvre le workflow. Si tu veux d'abord situer la plateforme, l'Avis n8n et la Formation n8n reprennent ces notions de zéro.

Connexion

Comment connecter Wekan à n8n ?

  1. 01

    Installer Wekan sur ton serveur

    Le nœud s'adresse à ta propre instance, donc Wekan doit tourner sur un serveur que tu contrôles avant toute autre étape. Note le domaine où il répond : cette valeur part telle quelle dans le credential. n8n peut vivre à côté, sur le même auto-hébergement, ou sur n8n Cloud, l'offre hébergée par n8n. Le workflow est identique dans les deux cas, seul le chemin réseau entre n8n et Wekan change.

  2. 02

    Créer le credential Wekan

    Dans n8n, ouvre le menu Credentials et choisis le credential Wekan. Un credential, c'est une fiche d'identifiants créée une fois et réutilisée par tous les workflows. Celui-ci fonctionne en basic auth et demande trois valeurs : Username, ton identifiant Wekan, Password, le mot de passe du même compte, et URL, le domaine Wekan noté à l'étape précédente. Le nœud te le propose ensuite dans sa liste déroulante.

  3. 03

    Tester sur une lecture

    Ajoute un nœud Wekan, prends la ressource Board et l'opération Get Many, puis choisis un utilisateur dans User Name or ID. Une exécution te dit si le credential répond et si le compte voit bien les tableaux attendus. Une lecture ne modifie rien dans Wekan et te montre le format réel des identifiants, celui que tu colleras ensuite dans des expressions du type {{ $json._id }}, la manière dont n8n récupère un champ de l'item précédent.

Actions

Que sait faire le nœud Wekan ?

Le nœud Wekan expose 24 opérations sur 6 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
RessourceCreateGetGet ManyUpdateDelete
Board✓✓✓✓
Card✓✓✓✓✓
Card Comment✓✓✓✓
Checklist✓✓✓✓
Checklist Item✓✓✓
List✓✓✓✓

Board

4 opérations
01

Create a board

board.create

Ce que tu vois dans n8n

Notes & cas d'usage

L'opération ouvre un tableau dans Wekan et renvoie son identifiant, la valeur que toutes les autres opérations réclament ensuite.

Paramètres clés

  • Title : le nom affiché du tableau, souvent un nom de client ou un numéro de dossier.
  • Owner Name or ID : l'identifiant de l'utilisateur Wekan propriétaire, pris dans la liste ou posé par expression.
  • Additional Fields : 7 réglages optionnels, dont Permission (private ou public), Color parmi 6 teintes, et Admin pour faire du propriétaire un admin du tableau.
Cas d'usage
un cabinet qui ouvre un tableau par dossier le crée dès la signature, avec le même code couleur à chaque fois.
02

Delete a board

board.delete

Ce que tu vois dans n8n

Notes & cas d'usage

Retire un tableau de Wekan à partir de son identifiant. L'appel est définitif, donc mets une condition ou une validation humaine juste avant.

Paramètres clés

  • Board ID : l'identifiant du tableau à supprimer, saisi en texte et non choisi dans une liste, en général transmis par un nœud précédent via une expression.
Cas d'usage
un ménage mensuel qui liste les tableaux, filtre ceux ouverts pour une démo et ne supprime que ceux-là.
03

Get a board

board.get

Ce que tu vois dans n8n

Notes & cas d'usage

Lit un tableau précis et renvoie ses données, de quoi faire brancher la suite du workflow sur ce qu'elle trouve.

Paramètres clés

  • Board ID : champ texte, la valeur vient donc d'un nœud précédent ou d'un identifiant que tu gardes dans le workflow.
Cas d'usage
avant de créer une carte, vérifier que le tableau visé existe encore et récupérer son titre, pour que la notification envoyée derrière nomme le tableau au lieu d'afficher un identifiant brut.
04

Get many boards

board.getAll

Ce que tu vois dans n8n

Notes & cas d'usage

Renvoie les tableaux rattachés à un utilisateur Wekan. C'est par là qu'un workflow découvre ce qui existe au lieu de figer des identifiants.

Paramètres clés

  • User Name or ID : l'utilisateur dont tu veux les tableaux, choisi dans la liste ou donné par expression.
  • Return All : coché, n8n enchaîne les pages de l'API et ramène tous les tableaux ; décoché, Limit plafonne le nombre renvoyé.
Cas d'usage
un inventaire qui recense les tableaux d'un compte de service et alimente un suivi de ce qui sert vraiment.

Card

5 opérations
05

Create a card

card.create

Ce que tu vois dans n8n

Notes & cas d'usage

Pose une carte dans une colonne et renvoie son identifiant. Cinq paramètres requis la placent au bon endroit du tableau.

Paramètres clés

  • Board Name or ID et List Name or ID : le tableau, puis la colonne d'arrivée.
  • Swimlane Name or ID : le couloir horizontal de la carte, demandé même si ton tableau n'en utilise qu'un.
  • Author Name or ID : l'utilisateur Wekan crédité de la carte.
  • Title : le nom de la carte, souvent {{ $json.title }} venu de l'item entrant.
  • Additional Fields : 3 valeurs optionnelles, Description, Assignee Names or IDs et Member Names or IDs.
Cas d'usage
une demande reçue par formulaire devient une carte dans la colonne d'entrée, description remplie avec le message.
06

Delete a card

card.delete

Ce que tu vois dans n8n

Notes & cas d'usage

Supprime une carte. Le nœud descend la hiérarchie pour la retrouver, donc trois identifiants voyagent ensemble.

Paramètres clés

  • Board Name or ID : le tableau auquel appartient la colonne.
  • List Name or ID : la colonne qui contient la carte.
  • Card Name or ID : la carte visée, via la liste ou une expression.
Cas d'usage
un détecteur de doublons qui compare les demandes entrantes, garde la carte la plus ancienne et supprime celle créée par un double envoi.
07

Get a card

card.get

Ce que tu vois dans n8n

Notes & cas d'usage

Récupère une carte et passe ses données au nœud suivant, titre et description compris.

Paramètres clés

  • Board Name or ID et List Name or ID : le chemin qui mène à la carte.
  • Card ID : champ texte ici, contrairement à la suppression, donc l'identifiant arrive par une expression du type {{ $json.cardId }}.
Cas d'usage
une relance quotidienne qui lit la carte derrière une échéance et glisse sa description à jour dans le message envoyé à la personne assignée.
08

Get many cards

card.getAll

Ce que tu vois dans n8n

Notes & cas d'usage

Renvoie les cartes d'une colonne ou d'un couloir, selon l'axe de lecture que tu donnes au nœud.

Paramètres clés

  • From Object : list ou swimlane, la façon dont le nœud parcourt le tableau.
  • Board Name or ID et List Name or ID : le tableau et la colonne lus.
  • Swimlane Name or ID : optionnel, utile quand le tableau sépare le travail par équipe ou par client.
  • Return All : coché, toutes les cartes remontent page après page ; décoché, Limit arrête la lecture.
Cas d'usage
un point du lundi qui compte les cartes encore en cours et publie le chiffre à l'équipe.
09

Update a card

card.update

Ce que tu vois dans n8n

Notes & cas d'usage

Modifie une carte existante sans toucher aux champs laissés vides. C'est aussi l'opération qui déplace une carte d'une colonne à l'autre.

Paramètres clés

  • Board Name or ID, List Name or ID et Card Name or ID : la carte éditée.
  • Update Fields : 17 valeurs optionnelles. Le List Name or ID de cette collection effectue le déplacement, Due At, Start At et End At portent les dates, Color signale visuellement, Spent Time enregistre le temps passé.
Cas d'usage
une facture marquée payée dans l'outil de gestion fait glisser la carte correspondante en colonne terminée.

Card Comment

4 opérations
10

Create a comment on a card

cardComment.create

Ce que tu vois dans n8n

Notes & cas d'usage

Publie un commentaire sous une carte, signé par un utilisateur Wekan. C'est la façon la moins destructive pour un workflow d'écrire sur un tableau.

Paramètres clés

  • Board Name or ID, List Name or ID et Card Name or ID : la carte qui reçoit le commentaire.
  • Author Name or ID : l'utilisateur affiché comme auteur, en général un compte dédié aux automatisations.
  • Comment : le texte, souvent construit à partir des données du nœud précédent.
Cas d'usage
chaque réponse reçue sur un dossier est recopiée sous la carte, l'historique reste là où l'équipe regarde déjà.
11

Delete a comment from a card

cardComment.delete

Ce que tu vois dans n8n

Notes & cas d'usage

Efface un commentaire précis, la carte elle-même n'est pas touchée.

Paramètres clés

  • Board Name or ID, List Name or ID et Card Name or ID : la carte qui porte le commentaire.
  • Comment Name or ID : le commentaire à retirer, choisi dans la liste ou identifié plus tôt par une lecture.
Cas d'usage
un workflow qui poste un statut provisoire sous une carte, puis retire son propre commentaire quand la vraie mise à jour arrive, pour que le fil ne se remplisse pas de bruit.
12

Get a card comment

cardComment.get

Ce que tu vois dans n8n

Notes & cas d'usage

Lit un commentaire et renvoie son contenu.

Paramètres clés

  • Board ID : champ texte sur cette opération, pas une liste déroulante, l'identifiant se passe donc directement.
  • List Name or ID et Card Name or ID : le chemin vers la carte.
  • Comment ID : également en texte, typiquement {{ $json._id }} issu d'une lecture précédente.
Cas d'usage
un workflow qui relit le commentaire qu'il vient de créer pour confirmer que le texte stocké dans Wekan correspond à ce qui a été envoyé.
13

Get many card comments

cardComment.getAll

Ce que tu vois dans n8n

Notes & cas d'usage

Ramène tout le fil de commentaires d'une carte en un appel, prêt à être résumé ou archivé.

Paramètres clés

  • Board Name or ID, List Name or ID et Card Name or ID : la carte dont tu lis le fil.
  • Return All : coché pour la discussion entière, décoché pour s'arrêter aux premiers commentaires selon Limit.
Cas d'usage
quand une carte arrive en colonne terminée, le fil complet part dans le compte rendu remis au client avant archivage du tableau.

Checklist

4 opérations
14

Create a checklist

checklist.create

Ce que tu vois dans n8n

Notes & cas d'usage

Attache une checklist à une carte, et la remplit dans le même appel si tu fournis les lignes.

Paramètres clés

  • Board Name or ID, List Name or ID et Card Name or ID : la carte qui reçoit la checklist.
  • Title : le nom de la checklist, souvent l'étape qu'elle couvre.
  • Items : optionnel, mais c'est lui qui fait gagner du temps, puisque les lignes arrivent avec la checklist au lieu d'un appel par ligne.
Cas d'usage
la carte d'un nouveau collaborateur reçoit sa checklist de première semaine, matériel, accès, présentations, dès la signature du contrat.
15

Delete a checklist

checklist.delete

Ce que tu vois dans n8n

Notes & cas d'usage

Retire une checklist entière d'une carte en un seul appel.

Paramètres clés

  • Board Name or ID, List Name or ID et Card Name or ID : la carte qui porte la checklist.
  • Checklist Name or ID : la checklist à supprimer, via la liste ou une expression.
Cas d'usage
une carte modèle est copiée pour chaque projet, et le workflow retire les checklists qui ne concernent pas celui-ci, histoire que la carte reste lisible.
16

Get a checklist

checklist.get

Ce que tu vois dans n8n

Notes & cas d'usage

Renvoie les données d'une checklist, ses éléments compris, ce qui permet au workflow de mesurer l'avancement.

Paramètres clés

  • Board Name or ID, List Name or ID et Card Name or ID : l'endroit où vit la checklist.
  • Checklist Name or ID : la checklist lue.
Cas d'usage
une barre de progression dans un suivi client, alimentée par le rapport entre lignes cochées et lignes totales de la checklist de livraison.
17

Get many checklists

checklist.getAll

Ce que tu vois dans n8n

Notes & cas d'usage

Liste toutes les checklists attachées à une carte. C'est le point d'entrée quand tu n'as pas encore leurs identifiants.

Paramètres clés

  • Board Name or ID, List Name or ID et Card Name or ID : la carte inspectée.
  • Return All : coché pour les avoir toutes, décoché pour s'arrêter à Limit.
Cas d'usage
un contrôle de nuit qui ouvre chaque carte de la colonne livraison, lit ses checklists et signale celles où rien n'a bougé.

Checklist Item

3 opérations
18

Delete a checklist item

checklistItem.delete

Ce que tu vois dans n8n

Notes & cas d'usage

Sort une seule ligne d'une checklist, le reste demeure en place.

Paramètres clés

  • Board Name or ID, List Name or ID et Card Name or ID : la carte concernée.
  • Checklist Name or ID : la checklist à laquelle la ligne appartient.
  • Checklist Item Name or ID : la ligne retirée.
Cas d'usage
une checklist d'arrivée montée pour tout le monde, dont la ligne badge d'accès disparaît automatiquement quand le poste est en télétravail.
19

Get a checklist item

checklistItem.get

Ce que tu vois dans n8n

Notes & cas d'usage

Lit une ligne de checklist et renvoie son état, ce qui permet à un workflow d'attendre une étape précise.

Paramètres clés

  • Board Name or ID, List Name or ID et Card Name or ID : le chemin vers la carte.
  • Checklist ID : champ texte sur cette opération, la valeur vient donc d'une lecture antérieure.
  • Checklist Item Name or ID : la ligne à lire.
Cas d'usage
un workflow de mise en ligne qui n'envoie l'annonce qu'une fois la ligne de recette revenue cochée.
20

Update a checklist item

checklistItem.update

Ce que tu vois dans n8n

Notes & cas d'usage

Coche une ligne, ou la renomme, sans toucher au reste de la checklist.

Paramètres clés

  • Board Name or ID, List Name or ID et Card Name or ID : la carte concernée.
  • CheckList Name or ID et Checklist Item Name or ID : la checklist puis la ligne exacte.
  • Update Fields : 2 valeurs, Finished pour cocher la case et Title pour réécrire la ligne.
Cas d'usage
l'outil comptable confirme un règlement, la ligne acompte reçu de la carte client se coche sans que personne n'ouvre Wekan.

List

4 opérations
21

Create a list

list.create

Ce que tu vois dans n8n

Notes & cas d'usage

Ajoute une colonne à un tableau et renvoie son identifiant, celui que les cartes utilisent ensuite comme destination.

Paramètres clés

  • Board Name or ID : le tableau où la colonne est créée.
  • Title : le nom de la colonne, en général une étape de ton process.
Cas d'usage
juste après board.create, une boucle crée les quatre colonnes habituelles de l'équipe, pour que chaque nouveau tableau s'ouvre avec la même structure.
22

Delete a list

list.delete

Ce que tu vois dans n8n

Notes & cas d'usage

Supprime une colonne d'un tableau. Deux identifiants suffisent, puisqu'une liste dépend directement de son tableau.

Paramètres clés

  • Board Name or ID : le tableau auquel la colonne appartient.
  • List Name or ID : la colonne supprimée, choisie dans la liste déroulante ou désignée par une expression quand son identifiant vient d'un nœud précédent.
Cas d'usage
à la fin d'une opération saisonnière, les colonnes temporaires créées pour elle disparaissent alors que les colonnes permanentes restent intactes.
23

Get a list

list.get

Ce que tu vois dans n8n

Notes & cas d'usage

Une colonne lue par son identifiant : l'opération rend son titre et ses données, pratique quand une carte ne transporte qu'un identifiant de liste.

Paramètres clés

  • Board Name or ID : le tableau parent.
  • List ID : champ texte, la valeur passe donc par une expression plutôt que par un choix dans la liste.
Cas d'usage
une notification qui précise dans quelle colonne une carte vient d'arriver, en traduisant l'identifiant de liste en nom lisible avant l'envoi.
24

Get many lists

list.getAll

Ce que tu vois dans n8n

Notes & cas d'usage

Renvoie les colonnes d'un tableau, le moyen le plus rapide de cartographier un tableau avant d'y écrire quoi que ce soit.

Paramètres clés

  • Board Name or ID : le tableau dont tu lis les colonnes.
  • Return All : coché, toutes les colonnes remontent ; décoché, Limit plafonne le résultat.
Cas d'usage
un workflow qui repère la colonne portant le nom du mois en cours, puis y crée la carte, sans aucun identifiant écrit en dur dans le nœud.
Besoin d'aide

Besoin d'aide pour automatiser Wekan avec n8n ?

L'équipe te répond directement.

Chaque message est lu par une personne.

FAQ

Wekan et n8n, les questions qui reviennent

01L'intégration Wekan n8n est-elle gratuite ?
Oui du côté n8n. Le nœud Wekan est livré avec n8n : rien à installer, aucun coût supplémentaire, que tu sois sur n8n Cloud ou sur une instance auto-hébergée de la Community Edition sous licence Sustainable Use. Le workflow se comporte exactement pareil dans les deux cas. Ce que tu fournis, c'est le serveur Wekan lui-même, puisque le nœud parle à une instance que tu installes et héberges. Ce dossier documente uniquement la partie n8n : tout ce que coûte l'exploitation de Wekan, hébergement compris, sort de ce cadre et dépend de ton installation.
02Quels identifiants faut-il pour connecter Wekan ?
Un basic auth, et rien d'autre. Le credential Wekan de n8n demande trois valeurs : Username, ton identifiant Wekan, Password, le mot de passe du même compte, et URL, le domaine où répond ton instance. Tu crées cette fiche une fois dans le menu Credentials et tous les workflows la réutilisent, le nœud te la proposant dans une liste. Un détail compte en pratique : pour charger les listes complètes de paramètres, celle des auteurs notamment, le compte Wekan derrière le credential a besoin des permissions admin. Un compte normal, comment only ou worker s'authentifie sans souci mais laisse plusieurs listes vides.
03Quelles sont les limites du nœud Wekan ?
Le nœud expose 24 opérations réparties sur 6 ressources : tableau, liste, carte, commentaire de carte, checklist et élément de checklist. Tout ce que l'API Wekan propose au-delà reste accessible avec le nœud HTTP Request, qui appelle n'importe quel endpoint en réutilisant le même credential via l'authentification prédéfinie. Deux points pratiques. Les opérations de lecture ne parcourent les pages de résultats que si Return All est activé, sinon Limit plafonne ce qui revient. Et tout fonctionne sur des identifiants Wekan plutôt que sur des noms : la valeur choisie dans une liste pendant la construction devient une expression une fois le workflow autonome.
04Wekan peut-il déclencher un workflow en temps réel ?
Non, parce que Wekan n'a pas de nœud trigger dans n8n. Un workflow qui touche à Wekan démarre toujours avec un autre déclencheur. Deux options couvrent la plupart des besoins. Le Schedule Trigger s'exécute à intervalle fixe, lit le tableau avec les opérations Get Many et réagit à ce qui a changé depuis la fois précédente, ce qui convient au reporting et au ménage. Le Webhook n8n, une URL qu'un service tiers appelle, lance le workflow au moment où quelque chose se produit ailleurs, dans un formulaire ou un outil de facturation, et le nœud Wekan écrit la carte derrière. Le trigger d'un autre outil fonctionne pareil.
05n8n ou Make pour Wekan ?
Ça dépend de l'endroit où tes données doivent rester. Wekan est un logiciel que tu héberges, et n8n s'héberge de la même façon avec Docker ou npm : le tableau comme l'automatisation restent alors sur tes serveurs. Make, ex-Integromat, est une plateforme hébergée sans option d'auto-hébergement, donc les appels vers ton instance Wekan transitent par un tiers. Le modèle de coût diffère aussi : Make facture à l'opération, un n8n auto-hébergé te coûte la machine qui le fait tourner. Make propose une construction visuelle que beaucoup d'équipes trouvent plus rapide au début, n8n laisse plus de place aux expressions et à la logique sur mesure des cas tordus.