Ressources · Intégration n8n

Intégration Kitemaker n8nAutomatiser Kitemaker avec n8n.

Un work item peut naître, se relire et se mettre à jour sans que personne ouvre Kitemaker. L'intégration Kitemaker n8n regroupe 7 opérations sur 4 ressources, au-dessus de l'API GraphQL de Kitemaker : organisation, space, utilisateur et work item. Aucun trigger n'est fourni, donc un autre nœud lance l'exécution.

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

Pourquoi automatiser

À quoi sert l'intégration Kitemaker n8n ?

L'intégration Kitemaker n8n relie ton organisation Kitemaker à n8n, l'outil d'automatisation qui s'installe chez toi avec Docker ou npm, ou s'utilise sur n8n Cloud. Le nœud consomme l'API GraphQL de Kitemaker et met 7 opérations à disposition sur 4 ressources. Un workflow peut donc créer un work item, le relire, le modifier, et lister les spaces et les utilisateurs de l'organisation connectée.

Premier terrain de jeu : la réunion qui produit une liste de tâches. Le compte rendu part dans un tableur, quelqu'un recopie, et la moitié des lignes n'arrive jamais dans l'outil. Une lecture de Microsoft Excel 365 suivie de workItem.create supprime l'étape de recopie, ligne par ligne, avec le bon space et le bon statut dès la création.

Deuxième usage : le rappel avant échéance. Un workflow déclenché chaque matin lit les items d'un space avec workItem.getAll, croise avec les rendez-vous de Google Calendar et prévient la personne concernée. Rien de spectaculaire, mais c'est le genre de tâche qu'une équipe oublie exactement le jour où ça compte.

Troisième usage : les deux outils qui racontent la même histoire. Beaucoup d'équipes techniques suivent leurs tickets ailleurs, par exemple dans Jira Software, et Kitemaker prend du retard. Un workflow qui écoute le changement puis appelle workItem.update remet les deux au même niveau, et comme les champs de mise à jour sont optionnels, il touche au statut sans réécrire le titre.

Quand une opération te manque, le nœud HTTP Request appelle n'importe quel endpoint de l'API Kitemaker en réutilisant le même credential via l'authentification prédéfinie. C'est la sortie de secours prévue, et elle évite de gérer un deuxième jeton dans un coin.

Deux points à anticiper. La lecture est paginée : avec Return All décoché, c'est Limit qui fixe le nombre maximal d'items renvoyés, parfait pour un test et insuffisant pour un export. Ensuite, un champ requis laissé vide bloque l'exécution du nœud, ce qui vaut mieux qu'un item créé à moitié. La Formation n8n reprend les expressions et les credentials si ces notions sont neuves pour toi.

Connexion

Comment connecter Kitemaker à n8n ?

  1. 01

    Ouvrir le compte Kitemaker

    La documentation des credentials ne demande qu'un prérequis : un compte Kitemaker. Le nœud agit ensuite au nom du compte qui a produit le jeton, ce qui explique la formulation des opérations, tournées vers l'organisation de l'utilisateur connecté. Choisis dès le départ entre un compte personnel et un compte dédié à l'automatisation, parce que chaque item créé portera cette identité.

  2. 02

    Générer le jeton d'accès personnel

    Kitemaker propose une seule méthode d'authentification côté n8n : un jeton d'accès API. Dans Kitemaker, va dans Manage > Developer settings et génère un Personal Access Token. La documentation d'authentification de l'API Kitemaker détaille le même chemin. Copie la valeur tout de suite et range-la dans un endroit que tu maîtrises : ce jeton est la seule barrière entre un workflow et tes work items.

  3. 03

    Enregistrer le credential dans n8n

    Dans n8n, ouvre le menu Credentials et crée un credential Kitemaker, c'est-à-dire l'identifiant que n8n stocke et réutilise à ta place. Colle le jeton d'accès personnel, enregistre, puis ouvre un nœud Kitemaker : le credential apparaît dans sa liste déroulante. Tu le crées une fois et tous les workflows de l'instance peuvent le sélectionner, sur n8n Cloud comme sur une instance auto-hébergée.

Actions

Que sait faire le nœud Kitemaker dans n8n ?

Le nœud Kitemaker expose 7 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.

Matrice ressources × opérations
RessourceCreateGetGet ManyUpdate
Organization
Space
User
Work Item

Organization

1 opération
01

Get the logged-in user's organization

organization.get

Ce que tu vois dans n8n

Notes & cas d'usage

L'opération récupère les données de l'organisation derrière le jeton connecté et la renvoie en un seul item. Rien à paramétrer, ce qui en fait le moyen le moins coûteux de vérifier qu'un credential fonctionne encore.

Cas d'usage
place-la en tête d'un workflow planifié, en guise de contrôle. Si le nœud échoue, le jeton a été révoqué et l'exécution s'arrête là, avant qu'une étape de création ne sème des work items dans le space.

Space

1 opération
02

Get many spaces

space.getAll

Ce que tu vois dans n8n

Notes & cas d'usage

Les spaces découpent le travail dans Kitemaker. Cette opération récupère les données de plusieurs spaces de l'organisation connectée, chacun arrivant sous forme d'item distinct, prêt à être parcouru en boucle.

Paramètres clés

  • Return All : coché, n8n enchaîne les pages de l'API et ramène tous les spaces ; décoché, Limit fixe combien de spaces sortent du nœud.
Cas d'usage
résoudre le space juste avant une création, pour qu'un item écrit par une automatisation n'atterrisse jamais au mauvais endroit.

User

1 opération
03

Get many users

user.getAll

Ce que tu vois dans n8n

Notes & cas d'usage

Plutôt que de maintenir une liste de collègues à la main quelque part, demande-la à Kitemaker. L'opération récupère les données de plusieurs utilisateurs de l'organisation connectée, un item par personne.

Paramètres clés

  • Return All : coché, le nœud parcourt tout l'annuaire ; décoché, Limit plafonne le nombre d'utilisateurs renvoyés, ce qui suffit pour un coup d'œil.
Cas d'usage
un contrôle mensuel qui compare les personnes présentes dans l'organisation Kitemaker à celles encore listées côté RH.

Work Item

4 opérations
04

Create a work item

workItem.create

Ce que tu vois dans n8n

Notes & cas d'usage

C'est là que la plupart des workflows Kitemaker se terminent : le nœud crée l'item, et l'exécution laisse enfin une trace visible par l'équipe.

Paramètres clés

  • Title : le titre du work item à créer, souvent une expression du type {{ $json.field }} qui reprend la donnée du nœud précédent.
  • Space Name or ID : choisis le space dans la liste, ou passe son ID par une expression quand il change à chaque exécution.
  • Status Name or ID : le statut posé sur le nouvel item, même choix entre la liste et l'expression.
  • Additional Fields : 5 champs optionnels, dont Description, qui accepte le Markdown.
Cas d'usage
un incident remonté par un client arrive avec ses étapes déjà mises en forme dans la description.
05

Get a work item

workItem.get

Ce que tu vois dans n8n

Notes & cas d'usage

Un item, par son identifiant. Utile quand une étape suivante a besoin de l'état courant d'un seul work item, et pas d'une liste qu'il faudrait filtrer ensuite.

Paramètres clés

  • Work Item ID : l'ID du work item à récupérer. Il est requis, donc une valeur vide bloque le nœud ; alimente-le par une expression comme {{ $json.field }} quand il vient d'un nœud précédent.
Cas d'usage
une commande dans la messagerie d'équipe qui répond avec l'item mentionné, sans que personne ouvre Kitemaker.
06

Get many work items

workItem.getAll

Ce que tu vois dans n8n

Notes & cas d'usage

Lire tout un pan de travail d'un coup, au lieu d'un item à la fois : voilà le rôle de cette opération, qui renvoie les work items d'un space donné.

Paramètres clés

  • Space Name or ID : requis, l'ID du space dont on récupère les work items. À prendre dans la liste ou à passer par une expression.
  • Return All : coché pour un export complet ; décoché, c'est Limit qui décide du nombre d'items renvoyés.
Cas d'usage
un récapitulatif du lundi matin sur le contenu d'un space, envoyé avant la réunion d'équipe.
07

Update a work item

workItem.update

Ce que tu vois dans n8n

Notes & cas d'usage

Modifier un item existant vaut mieux que d'en créer un doublon. Le nœud met à jour le work item que tu lui désignes et laisse intact chaque champ que tu ne remplis pas.

Paramètres clés

  • Work Item ID : requis, l'ID du work item à mettre à jour.
  • Update Fields : 5 champs optionnels, parmi lesquels Status Name or ID, Title et Description, qui accepte le Markdown.
Cas d'usage
une mise en production se termine, le workflow change le statut de l'item concerné et ajoute les notes de version dans sa description.
Besoin d'aide

Besoin d'aide pour automatiser Kitemaker avec n8n ?

L'équipe te répond directement.

Chaque message est lu par une personne.

FAQ

Kitemaker et n8n, les questions qui viennent ensuite

01L'intégration Kitemaker n8n est-elle gratuite ?
Oui, côté n8n. Le nœud Kitemaker est livré avec n8n : rien à installer, aucun coût supplémentaire, que tu passes par n8n Cloud ou par une instance auto-hébergée en Community Edition sous licence Sustainable Use. Un workflow se comporte de la même façon dans les deux cas, donc tu peux le construire sur ton poste et le déplacer sur un serveur sans retoucher les étapes Kitemaker. Ce que coûte Kitemaker lui-même est une autre question, et la documentation n8n n'y répond pas : c'est à vérifier directement auprès de Kitemaker.
02Quels credentials faut-il pour connecter Kitemaker à n8n ?
Un seul : un jeton d'accès API. Le prérequis, c'est un compte Kitemaker. Tu génères ensuite un Personal Access Token depuis Manage, puis Developer settings, et la documentation d'authentification de l'API Kitemaker détaille la manipulation. Ce jeton va dans un credential Kitemaker côté n8n, autrement dit l'identifiant que n8n conserve pour toi. Tu le crées une fois depuis le menu Credentials, et chaque nœud Kitemaker de l'instance te le propose dans sa liste déroulante. Le deuxième workflow ne demande donc rien de plus que de le sélectionner.
03Quelles sont les limites du nœud Kitemaker dans n8n ?
Deux méritent d'être connues. La lecture est paginée : sur les opérations qui listent les spaces, les utilisateurs ou les work items, Return All enchaîne les pages de l'API, et s'il est décoché, Limit fixe le nombre maximal d'items renvoyés. L'oublier sur un export donne un fichier incomplet. Ensuite, un champ marqué requis bloque l'exécution du nœud s'il est vide : une création sans titre échoue au lieu d'écrire un item bancal. Pour tout ce qui sort des 7 opérations, le nœud HTTP Request appelle n'importe quel endpoint de l'API Kitemaker en réutilisant le même credential via l'authentification prédéfinie.
04Le nœud Kitemaker réagit-il en temps réel ?
Non, il ne réagit pas tout seul. Kitemaker n'a pas de nœud trigger dans n8n, donc un workflow autour de lui démarre avec un autre point d'entrée. Les trois habituels : un Schedule Trigger qui se déclenche à intervalle fixe et relit l'état d'un space, un Webhook n8n, c'est-à-dire une URL exposée par n8n et appelée par un service tiers, ou le trigger d'un autre outil déjà présent dans ton installation. En pratique, une lecture planifiée combinée à l'opération Get many work items couvre la majorité des besoins.
05n8n ou Make pour Kitemaker ?
Ça dépend de quatre critères, et le prix n'en est qu'un. L'hébergement d'abord : Make est une plateforme hébergée, sans option d'auto-hébergement, alors que n8n tourne sur ton serveur ou sur n8n Cloud. La maîtrise des données en découle, puisqu'une instance auto-hébergée garde le contenu des work items sur une infrastructure qui t'appartient. Le modèle de coût ensuite : Make facture à l'opération, donc un workflow qui parcourt tous les spaces de l'organisation se paie au volume lu. La logique visuelle enfin : les deux construisent sur un canevas, le vrai test est de refaire un workflow Kitemaker réel dans chacun.
Hack'celeration Lab

Reçois nos tips intégration chaque semaine.

Pas de spam. Désinscription à tout moment.