Recursos · Integración n8n

Integración Linear n8nAutomatiza Linear con n8n.

¿Un issue de Linear creado en el instante en que algo falla en otra herramienta? La integración Linear n8n se apoya en dos nodos: 7 operaciones sobre issues y comentarios, y un trigger que escucha 6 recursos de eventos repartidos en 5 familias. Pensada para equipos que llevan su desarrollo en Linear.

Probar la integración Linear en n8nVer las 7 operaciones

Reseñas verificadas en Trustpilot · Agencia de IA, automatización y growth

Por qué automatizar

¿Qué cubre de verdad la integración Linear n8n?

La integración Linear n8n se reduce a dos nodos que comparten una misma conexión. El nodo Linear llama a la API de Linear para crear, leer, modificar y borrar issues, y para escribir comentarios debajo. El Linear Trigger arranca un flujo cuando Linear avisa de un cambio, por ejemplo un issue que se mueve o un comentario nuevo. Una sola credencial vale para los dos, así que una configuración cubre lectura y escritura.

Hay tres montajes que se repiten. El primero es el ticket que se abre solo. Un mensaje de cliente aterriza en Slack, un paso de clasificación decide que es un fallo, y el flujo lanza issue.create con el Team Name or ID correcto y un título sacado del mensaje. Quien avisó recibe el issue en ese mismo hilo.

El segundo es el repaso semanal. issue.getAll con Return All activado recorre todas las páginas de la API y entrega la lista entera al nodo siguiente, que la vuelca en Notion o en una hoja compartida antes de la reunión. Los equipos que llegan desde Jira Software o desde ClickUp suelen montar esto primero, porque enseña lo que de verdad está en marcha.

El tercero va en sentido contrario. El Linear Trigger se suscribe por webhook, es decir una URL que Linear llama cada vez que ocurre un evento, así que un cambio en un issue llega a n8n en segundos. Desde ahí issue.addLink engancha la publicación o la revisión al ticket, y comment.addComment escribe el desenlace justo debajo.

El nodo es estrecho a propósito: dos recursos, Issue y Comment, y 7 operaciones en total. Ciclos, proyectos y etiquetas se vigilan con el trigger, pero ninguna operación los escribe. Lo mismo pasa con equipos y personas, que solo existen como valores de lista dentro de otras operaciones. Cuando falta una operación, el nodo HTTP Request llama a cualquier endpoint de la API de Linear reutilizando la misma credencial, la conexión que se guarda una vez en el menú Credentials de n8n, mediante la autenticación predefinida.

Conviene tener claros dos límites antes de montar nada. Get Many solo expone Return All y Limit, así que acotar una lista por equipo o por estado ocurre después, en un nodo Filter. Y los campos de lista, equipo, estado, responsable, guardan un identificador y no la etiqueta que lees en Linear: el desplegable lo resuelve, una expresión tiene que aportarlo. Si la plataforma todavía está en duda, la Reseña n8n desglosa los criterios.

Conexión

¿Cómo conectar Linear con n8n?

  1. 01

    Elegir el método de autenticación

    La credencial de Linear viene en dos formatos, API Token y OAuth2. Para un flujo que corre bajo una única cuenta de servicio, la clave de API es el camino corto: una clave, un campo, listo. Para una aplicación donde cada persona autoriza su propio acceso, encaja mejor OAuth2. Los dos métodos funcionan en el nodo Linear y en el Linear Trigger, y una sola credencial sirve para ambos.

  2. 02

    Crear una clave de API personal

    En Linear, abre Settings y luego Security and access, y crea una clave de API personal dedicada. Pégala en el campo API Key de la credencial de n8n. Ponle a la credencial el nombre de su dueño: una clave personal actúa en nombre de esa persona, así que cada issue y cada comentario que escriba el flujo se le atribuyen. La credencial se crea una vez y luego se elige desde un desplegable en cada flujo.

  3. 03

    O registrar una aplicación OAuth2

    La credencial OAuth2 pide un Client ID y un Client Secret, los dos generados al crear la aplicación OAuth2 en Linear. Pega la OAuth Redirect URL que muestra n8n como URL de retorno en Linear. El ajuste Actor decide quién firma lo que escribe la aplicación: User crea issues y comentarios en nombre de quien autoriza, Application los crea en nombre de la propia aplicación.

Disparadores

¿Qué dispara un flujo desde Linear ?

Linear Trigger es el nodo que arranca un workflow cuando algo ocurre en Linear. Escucha 6 eventos, listados abajo por familia. Eliges uno o varios, activas el workflow y n8n registra el webhook (la URL que Linear llama) en tu cuenta.

Lo que ves en n8n

Todos los eventos, por familia

Una fila por objeto, un chip por acción. El evento que marcas en el nodo se escribe objeto.acción; pasa el cursor por un chip para leer cuándo se dispara.

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

Notas de configuración

01Set up the Linear TriggerEl Linear Trigger es el nodo que abre un flujo cuando Linear avisa de un cambio. Al activar el flujo, n8n registra un webhook en Linear, una URL que Linear llama en cada evento que corresponda, de modo que los items llegan en segundos y nada consulta la API cada cierto tiempo.

El Linear Trigger es el nodo que abre un flujo cuando Linear avisa de un cambio. Al activar el flujo, n8n registra un webhook en Linear, una URL que Linear llama en cada evento que corresponda, de modo que los items llegan en segundos y nada consulta la API cada cierto tiempo.

Parámetros clave

  • Listen to Resources: los recursos a los que te suscribes. Hay 6, repartidos en 5 familias, y marcar solo lo que el flujo trata mantiene legible la lista de ejecuciones.
  • Team Name or ID: opcional. Elige un equipo de la lista para acotar la suscripción, o pasa un identificador con una expresión, la sintaxis de n8n que lee un campo del item entrante, del estilo {{ $json.teamId }}.
Cuándo usarlo
siempre que un flujo deba reaccionar a Linear en lugar de escribirle. El nodo trigger está en versión 1, y una credencial OAuth2 usada aquí tiene que llevar el permiso de administración.
02Issue and Issue Label eventsDos de los 6 recursos hablan del objeto de trabajo. issue entrega los eventos sobre issues, issueLabel los que afectan a las etiquetas puestas encima. Comparten familia, y por eso es la más poblada del trigger.

Dos de los 6 recursos hablan del objeto de trabajo. issue entrega los eventos sobre issues, issueLabel los que afectan a las etiquetas puestas encima. Comparten familia, y por eso es la más poblada del trigger.

Parámetros clave

  • Listen to Resources: marca Issue para seguir los tickets, Issue Label para seguir cómo se etiquetan.
  • Team Name or ID: acotar a un equipo evita que un espacio de trabajo cargado despierte todos los flujos de la instancia.
Casos de uso
un cambio en un issue dispara una relectura con issue.get y luego una nota devuelta con comment.addComment. Un evento de etiqueta reencamina el ticket: marcado como fallo de cliente, recibe la conversación de soporte vía issue.addLink.
Cuándo usarlo
estos dos recursos van bien cuando al flujo le importa el ticket, no la charla alrededor.
03Issue Comment and Comment Reaction eventsLa conversación llega por una pareja de recursos. comment cubre Issue Comment, los mensajes escritos bajo un ticket, y reaction cubre Comment Reaction, las reacciones dejadas sobre esos mensajes. Cada uno forma su propia familia, así que se activan por separado.

La conversación llega por una pareja de recursos. comment cubre Issue Comment, los mensajes escritos bajo un ticket, y reaction cubre Comment Reaction, las reacciones dejadas sobre esos mensajes. Cada uno forma su propia familia, así que se activan por separado.

Parámetros clave

  • Listen to Resources: con Issue Comment suele bastar; añade Comment Reaction cuando una reacción tiene un significado pactado en el equipo.
  • Team Name or ID: aquí también sirve, porque el volumen de comentarios es lo que primero satura un trigger sin acotar.
Casos de uso
un comentario que menciona a un cliente abre su ficha en otra herramienta, o una reacción usada como validación hace avanzar el ticket con issue.update. Pon un nodo Filter justo después del trigger si solo cuentan algunos comentarios.
Cuándo usarlo
cuando lo que se dice bajo un ticket tiene que salir de Linear.
04Cycle and Project eventsLos objetos de planificación tienen recursos propios. cycle informa de lo que pasa en los ciclos, los periodos que Linear usa para agrupar trabajo, y project de lo que pasa en los proyectos. Un recurso cada uno, dos familias distintas, y ninguno tiene operación de escritura en el nodo Linear.

Los objetos de planificación tienen recursos propios. cycle informa de lo que pasa en los ciclos, los periodos que Linear usa para agrupar trabajo, y project de lo que pasa en los proyectos. Un recurso cada uno, dos familias distintas, y ninguno tiene operación de escritura en el nodo Linear.

Parámetros clave

  • Listen to Resources: Cycle y Project se marcan en el mismo trigger cuando un solo flujo lleva los dos ritmos.
  • Team Name or ID: un ciclo pertenece a un equipo, así que acotar pesa más aquí que en los comentarios.
Casos de uso
un evento de ciclo escribe el estado del sprint en un informe, y un evento de proyecto avisa a quienes nunca abren Linear. Como el nodo no sabe crear ni modificar estos objetos, los dos recursos quedan como señales de solo lectura: lo que venga después ocurre fuera.
Cuándo usarlo
para informes, y para tener al día a los equipos que no son técnicos.
Acciones

¿Qué sabe hacer el nodo Linear ?

El nodo Linear expone 7 operaciones en 2 recursos. Para cada una: el nodo tal como lo configuras en n8n, los campos obligatorios y nuestras notas de campo.

Matriz recursos × operaciones
RecursoCreateGetGet ManyUpdateDeleteAdd CommentAdd Link
Comment✓
Issue✓✓✓✓✓✓

Comment

1 operación
01

Add a comment to an issue

comment.addComment

Lo que ves en n8n

Notas y casos de uso

Escribe un comentario bajo un issue existente y devuelve el comentario creado. Es la forma que tiene un flujo de responder dentro de Linear en vez de dejar la respuesta en otra herramienta.

Parámetros clave

  • Issue ID: el identificador del issue que recibe el comentario, casi siempre {{ $json.id }} traído por un nodo anterior.
  • Comment: el texto del mensaje, construido con expresiones cuando tiene que citar el item entrante.
  • Parent Comment ID: dentro de Additional Fields, convierte el mensaje en respuesta bajo un comentario existente en lugar de uno nuevo.
Casos de uso
una alerta de monitorización añade su última medición bajo el ticket de incidencia abierto, y el hilo se lee de una sola vez.

Issue

6 operaciones
03

Create an issue

issue.create

Lo que ves en n8n

Notas y casos de uso

Abre un issue nuevo en el equipo elegido y lo devuelve, identificador incluido, listo para que lo reutilice el resto del flujo.

Parámetros clave

  • Team Name or ID: obligatorio. Elige el equipo en la lista, o pasa su identificador con una expresión cuando el equipo depende del item entrante.
  • Title: obligatorio, la línea que la gente lee en el backlog.
  • Priority: en Additional Fields, de 1 Urgent a 4 Low, con 0 para No Priority.
  • Assignee Name or ID, State Name or ID y Description: el resto de Additional Fields, suficiente para entregar un ticket ya clasificado.
Casos de uso
una respuesta de formulario sobre una función rota se convierte en issue del equipo de producto, asignado y en Urgent.
04

Delete an issue

issue.delete

Lo que ves en n8n

Notas y casos de uso

Borra un issue de Linear. La operación recibe un identificador y nada más, así que la protección tiene que estar antes en el flujo.

Parámetros clave

  • Issue ID: el issue que se elimina, leído de un paso anterior y no escrito a mano.
Casos de uso
una limpieza nocturna retira los tickets que un flujo de pruebas creó durante el día, reconocidos por una marca en el título. Pon delante un nodo IF que compruebe esa marca, porque el nodo borra el identificador que reciba, sea cual sea.
05

Get an issue

issue.get

Lo que ves en n8n

Notas y casos de uso

Lee un solo issue y devuelve sus campos tal como están ahora, que es lo que hace falta antes de decidir nada sobre él.

Parámetros clave

  • Issue ID: el identificador del issue a leer. Si viene del trigger ya está en el item; si viene de un mensaje de chat, hay que extraerlo antes.
Casos de uso
un flujo que persigue tickets parados vuelve a leer el issue justo antes de actuar, para no perseguir uno que alguien cerró 2 minutos antes.
06

Get many issues

issue.getAll

Lo que ves en n8n

Notas y casos de uso

Devuelve una lista de issues en lugar de uno solo. No hay campo obligatorio, así que la operación funciona en cuanto eliges la credencial.

Parámetros clave

  • Return All: activado, n8n encadena las páginas de la API hasta traer todos los issues. Va bien para una exportación, pesa mucho en un flujo que corre cada 5 minutos.
  • Limit: el número máximo de issues devueltos cuando Return All queda desactivado, lo que mantiene corta una prueba.
Casos de uso
un resumen de los lunes recoge los issues, los agrupa por estado en un nodo Code y publica un recuento por equipo.
07

Update an issue

issue.update

Lo que ves en n8n

Notas y casos de uso

Modifica un issue existente y devuelve la versión actualizada. Solo cambian los campos que rellenas, el resto del ticket se queda igual.

Parámetros clave

  • Issue ID: obligatorio, y el único campo que la operación exige rellenar.
  • State Name or ID: en Update Fields, la columna a la que se mueve el ticket.
  • Priority Name/ID: también en Update Fields, 1 Urgent, 2 High, 3 Medium o Low, 0 No Priority.
  • Assignee Name or ID, Team Name or ID, Title y Description: los demás Update Fields, bastante para pasar un ticket a otro equipo sin abrir Linear.
Casos de uso
una respuesta de cliente en un hilo de soporte sube la prioridad del issue vinculado.
Necesitas ayuda

¿Necesitas ayuda para automatizar Linear con n8n?

El equipo te responde directamente.

Cada mensaje lo lee una persona.

FAQ

Linear y n8n, preguntas frecuentes

01¿La integración Linear n8n es gratis?
Sí por el lado de n8n. El nodo Linear y el Linear Trigger vienen incluidos con n8n, así que no hay nada que instalar ni coste añadido, tanto si el flujo corre en n8n Cloud como en una instancia propia en Community Edition, bajo licencia Sustainable Use. Entre los dos nodos cubres 7 operaciones y 6 recursos de eventos sin ningún módulo de pago. Lo que cuesta un espacio de Linear es otra cuestión, depende del plan contratado, y eso se mira en Linear. Si alojas n8n tú mismo, la única factura es la del servidor donde corre la instancia.
02¿Qué credenciales o permisos necesita el nodo Linear?
Hay dos métodos y los dos valen para el nodo y para el trigger. La credencial API Token espera una clave de API personal creada en Linear, en Settings y luego Security and access. Va ligada a quien la crea, así que todo lo que escribe el flujo se le atribuye a esa persona. La credencial OAuth2 espera un Client ID y un Client Secret de una aplicación OAuth2, más un ajuste Actor: User hace que la aplicación actúe en nombre de quien autoriza, Application hace que actúe en el suyo. Para el Linear Trigger con OAuth2, la opción Include Admin Scope tiene que estar activada, o el webhook no se puede registrar.
03¿Qué límites tiene el nodo Linear en n8n?
Escribe issues y comentarios, y ahí se para. Dos recursos y 7 operaciones: crear, leer, listar, modificar, borrar y añadir un enlace del lado del issue, añadir un comentario del otro. Ciclos, proyectos y etiquetas se vigilan con el trigger, pero ninguna operación los crea ni los modifica. Get Many ofrece Return All y Limit y nada más, así que acotar una lista se hace en un nodo Filter después de la llamada. Los campos de equipo, estado y responsable guardan identificadores y no los nombres que ves en pantalla, algo que importa en cuanto una expresión sustituye al desplegable. Para lo demás, HTTP Request alcanza la API de Linear con la misma credencial.
04¿El Linear Trigger reacciona en tiempo real?
Casi. El trigger funciona por webhook: al activar el flujo, n8n registra una URL de retorno en Linear, y Linear llama a esa URL en el momento en que ocurre el evento. La recepción tarda segundos, nada consulta la API cada cierto tiempo, así que no hay frecuencia que ajustar ni hueco entre dos pasadas. Hay 6 recursos de eventos repartidos en 5 familias: issue e issue label, issue comment, comment reaction, cycle, project. Un detalle que conviene recordar: el registro ocurre al activar, así que un flujo apagado no recibe nada y los eventos de ese rato no llegan más tarde.
05¿n8n o Make para Linear?
Depende sobre todo de dónde deban vivir los flujos. Make lo aloja Make, sin opción de instalarlo en tu servidor, y factura por operación: previsible con poco volumen, bastante menos cuando un espacio de Linear activo hace saltar el trigger todo el día. n8n corre en Cloud o en tu propio servidor, así que los datos de los issues y las credenciales se quedan donde tú decides, y el coste sigue a la máquina y no al número de pasos. Los dos montan los flujos de forma visual. Cuando al nodo le falta una operación, n8n tira de HTTP Request con la misma credencial, y ese suele ser el punto que inclina la balanza.
Misma plataforma

Otros docs útiles sobre este stack.

Ver todas las integraciones