Ressources · Intégration n8n

Intégration Linear n8nAutomatiser Linear avec n8n.

Un ticket Linear ouvert à la seconde où quelque chose casse ailleurs ? L'intégration Linear n8n repose sur deux nœuds : 7 opérations sur les issues et les commentaires, et un trigger qui écoute 6 ressources d'événements réparties en 5 familles. Pensée pour les équipes qui pilotent leur dev dans Linear.

Tester l'intégration Linear sur n8nVoir les 7 opérations

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

Pourquoi automatiser

Que fait vraiment l'intégration Linear n8n ?

L'intégration Linear n8n tient en deux nœuds qui partagent la même connexion. Le nœud Linear appelle l'API Linear pour créer, lire, modifier et supprimer des tickets, et pour écrire des commentaires dessous. Le Linear Trigger, lui, démarre un workflow quand Linear signale un changement, par exemple un ticket qui bouge ou un commentaire ajouté. Un seul credential sert aux deux, donc une configuration couvre la lecture comme l'écriture.

Trois montages reviennent tout le temps. Le premier, c'est le ticket qui s'ouvre tout seul. Un message client arrive dans Slack, une étape de tri décide qu'il s'agit d'un bug, et le workflow lance issue.create avec le bon Team Name or ID et un titre construit à partir du message. La personne qui a signalé récupère le ticket dans le même fil.

Le deuxième, c'est le point du lundi. issue.getAll avec Return All activé parcourt toutes les pages de l'API et passe la liste complète au nœud suivant, qui l'écrit dans Google Sheets avant la réunion. Les équipes qui arrivent de Jira Software ou de ClickUp commencent souvent par ce montage, parce qu'il montre ce qui avance pour de bon.

Le troisième va dans l'autre sens. Le Linear Trigger s'abonne par webhook, c'est-à-dire une URL que Linear appelle à chaque événement, donc un changement de ticket arrive dans n8n en quelques secondes. Ensuite issue.addLink épingle la mise en production ou la relecture sur le ticket, et comment.addComment écrit le résultat en dessous.

Le nœud reste volontairement étroit : deux ressources, Issue et Comment, et 7 opérations en tout. Les cycles, les projets et les labels se surveillent avec le trigger, mais aucune opération ne les écrit. Pareil pour les équipes et les personnes, qui n'existent que comme valeurs de listes déroulantes dans d'autres opérations. Quand une opération manque, le nœud HTTP Request appelle n'importe quel endpoint de l'API Linear en réutilisant le même credential, la connexion enregistrée une fois dans le menu Credentials de n8n, via l'authentification prédéfinie.

Deux limites à connaître avant de construire. Get Many n'expose que Return All et Limit : filtrer par équipe ou par état se fait après l'appel, dans un nœud Filter. Et les champs à liste, équipe, état, assigné, stockent un identifiant et pas le libellé affiché dans Linear : la liste déroulante le résout, une expression doit le fournir elle-même. Si le choix de plateforme n'est pas tranché, l'Avis n8n détaille les arbitrages.

Connexion

Comment connecter Linear à n8n ?

  1. 01

    Choisir la méthode d'authentification

    Le credential Linear existe en deux variantes, API Token et OAuth2. Pour un workflow qui tourne sous un compte de service unique, la clé API va au plus court : une clé, un champ, terminé. Pour une application où chaque personne autorise son propre accès, OAuth2 est plus adapté. Les deux méthodes fonctionnent avec le nœud Linear comme avec le Linear Trigger, et un seul credential sert aux deux.

  2. 02

    Créer une clé API personnelle

    Dans Linear, ouvre Settings puis Security and access, et crée une clé API personnelle dédiée. Reporte-la dans le champ API Key du credential n8n. Nomme ce credential d'après son propriétaire : une clé personnelle agit au nom de cette personne, donc chaque ticket et chaque commentaire écrits par le workflow lui sont attribués. Le credential se crée une fois, ensuite il se choisit dans une liste déroulante à chaque workflow.

  3. 03

    Ou déclarer une application OAuth2

    Le credential OAuth2 demande un Client ID et un Client Secret, générés au moment où tu crées l'application OAuth2 côté Linear. Colle l'OAuth Redirect URL affichée par n8n comme URL de rappel dans Linear. Le réglage Actor décide de qui signe ce que l'application écrit : User crée les tickets et les commentaires au nom de la personne qui autorise, Application les crée en son nom propre.

Déclencheurs

Qu'est-ce qui déclenche un workflow depuis Linear ?

Linear Trigger est le nœud qui démarre un workflow quand quelque chose se passe dans Linear. Il écoute 6 é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 Linear 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.

issue.*2
  • issue.
    • issue
comment.*1
  • comment.
    • comment
cycle.*1
  • cycle.
    • cycle
project.*1
  • project.
    • project
reaction.*1
  • reaction.
    • reaction

Notes de configuration

01Set up the Linear TriggerLe Linear Trigger est le nœud qui ouvre un workflow quand Linear signale un changement. À l'activation du workflow, n8n enregistre un webhook auprès de Linear, une URL que Linear appelle à chaque événement concerné, donc les items arrivent en quelques secondes et rien n'interroge l'API à intervalle régulier.

Le Linear Trigger est le nœud qui ouvre un workflow quand Linear signale un changement. À l'activation du workflow, n8n enregistre un webhook auprès de Linear, une URL que Linear appelle à chaque événement concerné, donc les items arrivent en quelques secondes et rien n'interroge l'API à intervalle régulier.

Paramètres clés

  • Listen to Resources : les ressources auxquelles s'abonner. Il y en a 6, réparties en 5 familles, et ne cocher que ce que le workflow traite garde la liste des exécutions lisible.
  • Team Name or ID : facultatif. Choisis une équipe dans la liste pour restreindre l'abonnement, ou fournis un identifiant avec une expression, la syntaxe n8n qui lit un champ de l'item entrant, du type {{ $json.teamId }}.
Quand l'utiliser
dès qu'un workflow doit réagir à Linear plutôt que lui écrire. Le nœud trigger est en version 1, et un credential OAuth2 utilisé ici doit porter le droit d'administration.
02Issue and Issue Label eventsDeux des 6 ressources décrivent l'objet de travail lui-même. issue livre les événements sur les tickets, issueLabel ceux qui concernent les labels posés dessus. Elles appartiennent à la même famille, ce qui en fait la plus fournie du trigger.

Deux des 6 ressources décrivent l'objet de travail lui-même. issue livre les événements sur les tickets, issueLabel ceux qui concernent les labels posés dessus. Elles appartiennent à la même famille, ce qui en fait la plus fournie du trigger.

Paramètres clés

  • Listen to Resources : coche Issue pour suivre les tickets, Issue Label pour suivre la façon dont ils sont étiquetés.
  • Team Name or ID : restreindre à une équipe évite qu'un espace de travail chargé réveille tous les workflows de l'instance.
Cas d'usage
un changement sur un ticket déclenche une relecture avec issue.get, puis une note renvoyée avec comment.addComment. Un événement de label réoriente le ticket : étiqueté bug client, il reçoit la conversation de support via issue.addLink.
Quand l'utiliser
ces deux ressources servent quand le workflow s'intéresse au ticket, pas à la discussion autour.
03Issue Comment and Comment Reaction eventsLa discussion arrive par un duo de ressources. comment couvre Issue Comment, les messages écrits sous un ticket, et reaction couvre Comment Reaction, les réactions posées sur ces messages. Chacune forme sa propre famille, donc elles s'activent séparément.

La discussion arrive par un duo de ressources. comment couvre Issue Comment, les messages écrits sous un ticket, et reaction couvre Comment Reaction, les réactions posées sur ces messages. Chacune forme sa propre famille, donc elles s'activent séparément.

Paramètres clés

  • Listen to Resources : Issue Comment seul suffit dans la plupart des cas ; ajoute Comment Reaction quand une réaction a un sens convenu dans l'équipe.
  • Team Name or ID : utile ici aussi, parce que le volume de commentaires est ce qui sature en premier un trigger non restreint.
Cas d'usage
un commentaire qui cite un nom de client ouvre la fiche correspondante dans un autre outil, ou une réaction utilisée comme validation fait avancer le ticket avec issue.update. Mets un nœud Filter juste après le trigger si seuls certains commentaires comptent.
Quand l'utiliser
quand ce qui se dit sous un ticket doit sortir de Linear.
04Cycle and Project eventsLes objets de planification ont leurs propres ressources. cycle remonte ce qui touche aux cycles, les périodes que Linear utilise pour regrouper le travail, et project ce qui touche aux projets. Une ressource chacune, deux familles distinctes, et aucune des deux n'a d'opération d'écriture côté nœud Linear.

Les objets de planification ont leurs propres ressources. cycle remonte ce qui touche aux cycles, les périodes que Linear utilise pour regrouper le travail, et project ce qui touche aux projets. Une ressource chacune, deux familles distinctes, et aucune des deux n'a d'opération d'écriture côté nœud Linear.

Paramètres clés

  • Listen to Resources : Cycle et Project se cochent sur le même trigger quand un seul workflow gère les deux rythmes.
  • Team Name or ID : un cycle appartient à une équipe, donc restreindre compte plus ici que sur les commentaires.
Cas d'usage
un événement de cycle écrit l'état du sprint dans un rapport, un événement de projet prévient les gens qui n'ouvrent jamais Linear. Comme le nœud ne sait ni créer ni modifier ces objets, ces deux ressources restent des signaux en lecture seule : la suite se passe ailleurs.
Quand l'utiliser
pour le reporting, et pour tenir au courant les équipes qui ne sont pas techniques.
Actions

Que sait faire le nœud Linear ?

Le nœud Linear expose 7 opérations sur 2 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 ManyUpdateDeleteAdd CommentAdd Link
Comment✓
Issue✓✓✓✓✓✓

Comment

1 opération
01

Add a comment to an issue

comment.addComment

Ce que tu vois dans n8n

Notes & cas d'usage

Écrit un commentaire sous un ticket existant et renvoie le commentaire créé. C'est la façon pour un workflow de répondre dans Linear au lieu de laisser la réponse dans un autre outil.

Paramètres clés

  • Issue ID : l'identifiant du ticket qui reçoit le commentaire, le plus souvent {{ $json.id }} transmis par un nœud précédent.
  • Comment : le texte du message, construit avec des expressions quand il doit reprendre l'item entrant.
  • Parent Comment ID : dans Additional Fields, transforme le message en réponse sous un commentaire existant au lieu d'un nouveau.
Cas d'usage
une alerte de supervision ajoute sa dernière mesure sous le ticket d'incident ouvert, et le fil se lit d'un bloc.

Issue

6 opérations
03

Create an issue

issue.create

Ce que tu vois dans n8n

Notes & cas d'usage

Ouvre un ticket dans une équipe donnée et le renvoie, identifiant compris, prêt à être réutilisé par la suite du workflow.

Paramètres clés

  • Team Name or ID : requis. Choisis l'équipe dans la liste, ou passe son identifiant avec une expression quand l'équipe dépend de l'item entrant.
  • Title : requis, la ligne que les gens lisent dans le backlog.
  • Priority : dans Additional Fields, de 1 Urgent à 4 Low, avec 0 pour No Priority.
  • Assignee Name or ID, State Name or ID et Description : le reste d'Additional Fields, de quoi livrer un ticket déjà trié.
Cas d'usage
une réponse de formulaire sur une fonction cassée devient un ticket dans l'équipe produit, assigné et en Urgent.
04

Delete an issue

issue.delete

Ce que tu vois dans n8n

Notes & cas d'usage

Supprime un ticket dans Linear. L'opération prend un identifiant et rien d'autre, donc le garde-fou doit se placer avant elle dans le workflow.

Paramètres clés

  • Issue ID : le ticket à supprimer, lu dans une étape précédente plutôt que saisi à la main.
Cas d'usage
un nettoyage de nuit retire les tickets créés dans la journée par un workflow de test, repérés par un marqueur dans le titre. Mets un nœud IF devant qui vérifie ce marqueur, parce que le nœud supprime l'identifiant qu'on lui donne, quel qu'il soit.
05

Get an issue

issue.get

Ce que tu vois dans n8n

Notes & cas d'usage

Lit un seul ticket et renvoie ses champs à l'instant T, ce qu'il faut avant de décider quoi que ce soit à son sujet.

Paramètres clés

  • Issue ID : l'identifiant du ticket à lire. Venant du trigger, il est déjà dans l'item ; venant d'un message de chat, il faut l'extraire d'abord.
Cas d'usage
un workflow qui relance les tickets dormants relit le ticket juste avant d'agir, pour ne pas relancer celui que quelqu'un a fermé 2 minutes plus tôt.
06

Get many issues

issue.getAll

Ce que tu vois dans n8n

Notes & cas d'usage

Renvoie une liste de tickets au lieu d'un seul. Aucun champ n'est requis, donc l'opération tourne dès que le credential est sélectionné.

Paramètres clés

  • Return All : activé, n8n enchaîne les pages de l'API jusqu'à ce que tous les tickets soient remontés. Parfait pour un export, lourd pour un workflow qui tourne toutes les 5 minutes.
  • Limit : le nombre maximal de tickets renvoyés quand Return All reste désactivé, ce qui garde un test court.
Cas d'usage
un récapitulatif du lundi récupère les tickets, les regroupe par état dans un nœud Code et publie un compte par équipe.
07

Update an issue

issue.update

Ce que tu vois dans n8n

Notes & cas d'usage

Modifie un ticket existant et renvoie la version à jour. Seuls les champs remplis bougent, le reste du ticket reste tel quel.

Paramètres clés

  • Issue ID : requis, et seul champ obligatoire de l'opération.
  • State Name or ID : dans Update Fields, la colonne vers laquelle le ticket se déplace.
  • Priority Name/ID : aussi dans Update Fields, 1 Urgent, 2 High, 3 Medium ou Low, 0 No Priority.
  • Assignee Name or ID, Team Name or ID, Title et Description : les autres Update Fields, de quoi basculer un ticket vers une autre équipe sans ouvrir Linear.
Cas d'usage
une réponse client sur un fil de support monte la priorité du ticket lié.
Besoin d'aide

Besoin d'aide pour automatiser Linear avec n8n ?

L'équipe te répond directement.

Chaque message est lu par une personne.

FAQ

Linear et n8n, les questions fréquentes

01L'intégration Linear n8n est-elle gratuite ?
Oui côté n8n. Le nœud Linear et le Linear Trigger sont livrés avec n8n, donc rien à installer et aucun coût supplémentaire, que le workflow tourne sur n8n Cloud ou sur une instance auto-hébergée en Community Edition, sous licence Sustainable Use. Les deux nœuds couvrent ensemble 7 opérations et 6 ressources d'événements, sans module payant. Ce que coûte un espace Linear est une autre question, elle dépend du plan choisi, donc ça se vérifie côté Linear. En auto-hébergement, la seule facture est celle du serveur qui fait tourner l'instance.
02Quels credentials ou droits faut-il pour le nœud Linear ?
Deux méthodes existent, et toutes les deux couvrent le nœud et le trigger. Le credential API Token attend une clé API personnelle créée dans Linear, sous Settings puis Security and access. Elle est liée à la personne qui l'a créée, donc tout ce que le workflow écrit lui est attribué. Le credential OAuth2 attend un Client ID et un Client Secret issus d'une application OAuth2, plus un réglage Actor : User fait agir l'application au nom de la personne qui autorise, Application la fait agir en son nom. Pour le Linear Trigger en OAuth2, l'option Include Admin Scope doit être activée, sinon le webhook ne peut pas être enregistré.
03Quelles sont les limites du nœud Linear dans n8n ?
Il écrit des tickets et des commentaires, et s'arrête là. Deux ressources, 7 opérations : créer, lire, lister, modifier, supprimer et ajouter un lien côté ticket, ajouter un commentaire de l'autre côté. Les cycles, les projets et les labels se surveillent avec le trigger, mais aucune opération ne les crée ni ne les modifie. Get Many propose Return All et Limit, rien de plus, donc le tri d'une liste se fait dans un nœud Filter après l'appel. Les champs équipe, état et assigné contiennent des identifiants et pas les noms affichés, ce qui compte dès qu'une expression remplace la liste déroulante. Pour le reste, HTTP Request atteint l'API Linear avec le même credential.
04Le Linear Trigger réagit-il en temps réel ?
Presque. Le trigger fonctionne par webhook : à l'activation du workflow, n8n enregistre une URL de rappel auprès de Linear, et Linear appelle cette URL au moment où l'événement se produit. La réception prend quelques secondes, rien n'interroge l'API à intervalle régulier, donc pas de fréquence à régler ni de trou entre deux passages. Six ressources d'événements sont disponibles, réparties en 5 familles : issue et issue label, issue comment, comment reaction, cycle, project. Un point à retenir : l'enregistrement se fait à l'activation, donc un workflow inactif ne reçoit rien et les événements survenus pendant ce temps n'arrivent pas plus tard.
05n8n ou Make pour Linear ?
Ça dépend surtout de l'endroit où les workflows doivent vivre. Make est hébergé par Make, sans option d'auto-hébergement, et se facture à l'opération : prévisible à faible volume, beaucoup moins quand un espace Linear actif fait partir le trigger toute la journée. n8n tourne sur Cloud ou sur ton propre serveur, donc les données des tickets et les credentials restent où tu décides, et le coût suit la machine plutôt que le nombre d'étapes. Les deux construisent les workflows visuellement. Quand une opération manque au nœud, n8n bascule sur HTTP Request avec le même credential, et c'est souvent ce point qui tranche.
Même plateforme

Autres docs utiles sur ce stack.

Voir toutes les intégrations