Recursos · Integración n8n

Integración Kitemaker n8nAutomatiza Kitemaker con n8n.

Un work item puede crearse, consultarse y actualizarse sin que nadie abra Kitemaker. La integración Kitemaker n8n reúne 7 operaciones repartidas en 4 recursos, sobre la API GraphQL de la herramienta: organización, space, usuario y work item. No incluye ningún trigger, así que el flujo arranca desde otro nodo.

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

Por qué automatizar

¿Qué hace la integración Kitemaker n8n?

La integración Kitemaker n8n une tu organización de Kitemaker con n8n, la herramienta de automatización que puedes alojar tú con Docker o npm, o usar en n8n Cloud. El nodo consume la API GraphQL de Kitemaker y pone a tu alcance 7 operaciones sobre 4 recursos, de modo que un flujo de trabajo crea un work item, lo consulta, lo actualiza y lista los spaces y los usuarios de la organización conectada.

El primer caso nace en el correo. Las peticiones internas llegan a una bandeja compartida, alguien las lee y solo la mitad termina anotada. Un flujo que lee Gmail y llama a workItem.create convierte cada mensaje marcado en un work item con su space y su estado, y nadie vuelve a copiar a mano lo que ya estaba escrito.

El segundo caso es de dirección. Muchos equipos quieren ver el trabajo en curso sin entrar en la herramienta: workItem.getAll devuelve los items de un space y user.getAll devuelve a las personas de la organización, y ambos aterrizan en una hoja de Google Sheets que se actualiza sola cada semana.

El tercero aparece cuando conviven dos herramientas. Si las tareas operativas viven en ClickUp y el producto vive en Kitemaker, el estado se desincroniza en cuestión de días. Un flujo que detecta el cambio y llama a workItem.update los vuelve a alinear, y como los campos de actualización son opcionales, toca el estado sin reescribir el título ni la descripción.

Cuando la operación que necesitas no está entre las 7, el nodo HTTP Request llama a cualquier endpoint de la API de Kitemaker y reutiliza el mismo credential mediante la autenticación predefinida. Es la salida prevista y evita mantener un segundo token por ahí suelto.

Hay dos detalles que conviene prever. La lectura está paginada: con Return All desactivado, es Limit quien fija el número máximo de items devueltos, suficiente para una prueba y corto para un export. Y un campo marcado como requerido bloquea la ejecución del nodo si queda vacío, lo cual es mejor que un item creado a medias. Si las expresiones y los credentials te suenan lejanos, el Curso n8n los cubre antes de tocar un espacio real.

Conexión

¿Cómo conectar Kitemaker con n8n?

  1. 01

    Abre la cuenta de Kitemaker

    La documentación de credentials pide un único requisito previo: una cuenta de Kitemaker. El nodo actúa después en nombre de la cuenta que generó el token, y de ahí viene la redacción de las operaciones, siempre referidas a la organización del usuario conectado. Decide desde el principio si la automatización corre bajo una cuenta personal o una cuenta dedicada, porque cada item creado llevará esa identidad.

  2. 02

    Genera el token de acceso personal

    Kitemaker admite un método de autenticación del lado de n8n: un token de acceso a la API. Dentro de Kitemaker, entra en Manage > Developer settings y genera un Personal Access Token. La documentación de autenticación de la API de Kitemaker explica el mismo recorrido con más detalle. Copia el valor en ese momento y guárdalo donde tú controles: ese token es lo único que separa un flujo de tus work items.

  3. 03

    Guarda el credential en n8n

    En n8n, abre el menú Credentials y crea un credential de Kitemaker, es decir, el acceso que n8n almacena y reutiliza por ti. Pega el token de acceso personal, guarda y abre cualquier nodo Kitemaker: el credential aparece en su lista desplegable. Se crea una sola vez y todos los flujos de la instancia pueden seleccionarlo, tanto en n8n Cloud como en una instancia que alojes tú.

Acciones

¿Qué sabe hacer el nodo Kitemaker en n8n?

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

Matriz recursos × operaciones
RecursoCreateGetGet ManyUpdate
Organization
Space
User
Work Item

Organization

1 operación
01

Get the logged-in user's organization

organization.get

Lo que ves en n8n

Notas y casos de uso

La operación recupera los datos de la organización que hay detrás del token conectado y la devuelve como un único item. No hay nada que configurar, así que resulta la forma más barata de comprobar que un credential sigue vivo.

Casos de uso
ponla al principio de un flujo programado, a modo de control. Si el nodo falla, el token ha caducado o se ha revocado y la ejecución se detiene ahí, antes de que un paso de creación llene el space de items sueltos.

Space

1 operación
02

Get many spaces

space.getAll

Lo que ves en n8n

Notas y casos de uso

Los spaces son la forma que tiene Kitemaker de separar el trabajo. Esta operación recupera datos de varios spaces de la organización conectada, y cada uno llega como un item propio, listo para recorrerlo en bucle.

Parámetros clave

  • Return All: activado, n8n encadena las páginas de la API y trae todos los spaces; desactivado, Limit marca cuántos salen del nodo.
Casos de uso
resolver el space justo antes de una creación, para que un item escrito por una automatización no acabe en el sitio equivocado.

User

1 operación
03

Get many users

user.getAll

Lo que ves en n8n

Notas y casos de uso

En lugar de mantener a mano una lista de compañeros en cualquier documento, pídesela a Kitemaker. La operación recupera datos de varios usuarios de la organización conectada, con un item por persona.

Parámetros clave

  • Return All: activado, el nodo recorre el directorio entero; desactivado, Limit limita cuántos usuarios se devuelven, que suele bastar para una revisión rápida.
Casos de uso
una revisión mensual que compara quién está en la organización de Kitemaker con quién sigue en la lista de personal.

Work Item

4 operaciones
04

Create a work item

workItem.create

Lo que ves en n8n

Notas y casos de uso

Aquí terminan la mayoría de los flujos de Kitemaker: el nodo crea el item y la ejecución deja algo visible para el equipo.

Parámetros clave

  • Title: el título del work item que se va a crear, casi siempre una expresión del tipo {{ $json.field }} que recoge el dato anterior.
  • Space Name or ID: elige el space en la lista, o pasa su ID con una expresión cuando cambia en cada ejecución.
  • Status Name or ID: el estado con el que nace el item, con la misma elección entre lista y expresión.
  • Additional Fields: 5 campos opcionales, entre ellos Description, que admite Markdown.
Casos de uso
un fallo de un cliente llega con los pasos ya formateados en la descripción.
05

Get a work item

workItem.get

Lo que ves en n8n

Notas y casos de uso

Un item, por su identificador. Sirve cuando un paso posterior necesita el estado actual de un solo work item y no una lista que después habría que filtrar.

Parámetros clave

  • Work Item ID: el ID del work item que se quiere recuperar. Es requerido, así que un valor vacío detiene el nodo; aliméntalo con una expresión como {{ $json.field }} cuando venga de un nodo anterior.
Casos de uso
un comando en el chat del equipo que responde con el item mencionado, sin que nadie entre en Kitemaker.
06

Get many work items

workItem.getAll

Lo que ves en n8n

Notas y casos de uso

Leer de golpe todo un frente de trabajo, en vez de item por item: para eso está esta operación, que devuelve los work items de un space concreto.

Parámetros clave

  • Space Name or ID: requerido, el ID del space del que se recuperan los work items. Se elige en la lista o se pasa con una expresión.
  • Return All: activado para un export completo; desactivado, es Limit quien decide cuántos items vuelven.
Casos de uso
un resumen del lunes con el contenido de un space, enviado antes de la reunión de equipo.
07

Update a work item

workItem.update

Lo que ves en n8n

Notas y casos de uso

Modificar un item existente evita crear un duplicado. El nodo actualiza el work item que le indiques y deja intacto cada campo que no rellenes.

Parámetros clave

  • Work Item ID: requerido, el ID del work item que se va a actualizar.
  • Update Fields: 5 campos opcionales, entre ellos Status Name or ID, Title y Description, que admite Markdown.
Casos de uso
termina una puesta en producción, el flujo cambia el estado del item asociado y añade las notas de la versión en su descripción.
Necesitas ayuda

¿Necesitas ayuda para automatizar Kitemaker con n8n?

El equipo te responde directamente.

Cada mensaje lo lee una persona.

FAQ

Kitemaker y n8n, las preguntas que vienen después

01¿La integración Kitemaker n8n es gratuita?
Sí, por el lado de n8n. El nodo Kitemaker viene incluido con n8n, así que no hay nada que instalar ni ningún coste adicional, tanto si usas n8n Cloud como una instancia alojada por ti en Community Edition bajo licencia Sustainable Use. Un flujo se comporta igual en los dos casos, de modo que puedes montarlo en tu portátil y llevarlo a un servidor sin tocar los pasos de Kitemaker. Lo que cueste Kitemaker en sí es otra cuestión y la documentación de n8n no la responde: eso se confirma directamente con Kitemaker.
02¿Qué credentials hacen falta para conectar Kitemaker con n8n?
Solo uno: un token de acceso a la API. El requisito previo es tener una cuenta de Kitemaker. Después generas un Personal Access Token desde Manage y luego Developer settings, y la documentación de autenticación de la API de Kitemaker detalla el proceso. Ese token se guarda en un credential de Kitemaker dentro de n8n, es decir, el acceso que n8n conserva por ti. Se crea una vez desde el menú Credentials y cualquier nodo Kitemaker de la instancia lo ofrece en su lista desplegable, así que el segundo flujo solo tiene que seleccionarlo.
03¿Qué límites tiene el nodo Kitemaker en n8n?
Dos que conviene tener presentes. La lectura está paginada: en las operaciones que listan spaces, usuarios o work items, Return All encadena las páginas de la API, y si está desactivado, Limit fija el número máximo de items devueltos. Olvidarlo en un export deja un archivo incompleto. Además, un campo marcado como requerido bloquea la ejecución del nodo cuando está vacío, de forma que una creación sin título falla en lugar de escribir un item incompleto. Para todo lo que quede fuera de las 7 operaciones, el nodo HTTP Request llama a cualquier endpoint de la API de Kitemaker reutilizando el mismo credential mediante la autenticación predefinida.
04¿El nodo Kitemaker reacciona en tiempo real?
Por sí mismo no reacciona. Kitemaker no tiene nodo trigger en n8n, así que un flujo a su alrededor arranca desde otro punto de entrada. Los tres habituales: un Schedule Trigger que se dispara a intervalo fijo y vuelve a leer el estado de un space, un Webhook de n8n, o sea una URL que n8n expone y que llama un servicio externo, o el trigger de otra herramienta que ya tengas montada. En la práctica, una lectura programada junto a la operación Get many work items cubre casi todo, y el webhook cubre los casos en los que el otro sistema puede avisar por su cuenta.
05¿n8n o Make para Kitemaker?
Depende de cuatro criterios, y el precio es solo uno. El alojamiento: Make es una plataforma alojada, sin opción de instalarla en tu servidor, mientras que n8n corre en tu infraestructura o en n8n Cloud. De ahí sale el control de los datos, porque una instancia propia mantiene el contenido de los work items en máquinas tuyas. El modelo de coste: Make factura por operación, así que un flujo que recorre todos los spaces de la organización se paga por volumen leído. Y la lógica visual: los dos trabajan sobre un lienzo, y la prueba honesta es rehacer un flujo real de Kitemaker en cada uno.
Hack'celeration Lab

Recibe nuestros tips de integración cada semana.

Sin spam. Cancela cuando quieras.