Integración ClickUp n8nAutomatiza ClickUp con n8n.

Añade una checklist dentro de una tarea existente y le da al flujo un sitio donde escribir los pasos siguientes. Aparece en la tarea, bajo su propio título.

• Task ID: la tarea que recibe la checklist, a menudo {{ $json.id }} cuando un nodo de tarea se ejecuta justo antes.
• Name: el título de la checklist, donde suele ir la fase o la persona responsable.

Quita una checklist entera de su tarea, con todas sus líneas. No se archiva nada, así que la operación va al final de una rama que tengas controlada.

• Checklist ID: el identificador de la checklist, no el de la tarea que la contiene, un matiz que conviene revisar dos veces.

En una checklist ya creada cambian dos cosas: cómo se llama y en qué lugar aparece respecto a las demás. Sus líneas se quedan como están.

• Checklist ID: la checklist a modificar.
• Name: dentro de Update Fields, el nuevo título.
• Position: dentro de Update Fields, un número que fija su orden dentro de la tarea.

Escribe una línea dentro de una checklist existente y, si quieres, se la asigna a alguien en la misma llamada.

• Checklist ID: la checklist que recibe la línea.
• Name: el texto de la línea, mejor redactado como acción que como tema.
• Assignee ID: dentro de Additional Fields, el usuario de ClickUp responsable de esa línea.

Saca una sola línea de la checklist y deja el resto intacto. Hacen falta los dos identificadores, el de la checklist madre y el de la línea.

• Checklist ID: la checklist a la que pertenece la línea.
• Checklist Item ID: la línea que se elimina.

Modifica una línea sin volver a crearla: otro texto, otra persona, marcada o desmarcada, o colocada debajo de otra línea como subpaso.

• Checklist ID y Checklist Item ID: la línea que se edita y la checklist donde vive.
• Resolved: dentro de Update Fields, el booleano que marca la casilla.
• Parent Checklist Item ID: dentro de Update Fields, anida la línea bajo otra línea de la misma checklist.

Publica un comentario en una tarea, una lista o una vista, y puede avisar de paso a toda la gente que hay alrededor.

• Comment On: el tipo de destino, task, list o view.
• ID: el identificador de ese destino, el de una tarea cuando Comment On vale task.
• Comment Text: el cuerpo del mensaje.
• Notify All: dentro de Additional Fields, manda la notificación de creación a todo el mundo, incluido el autor del comentario.

Borra un comentario del objeto donde estaba publicado. Solo pide su identificador, y la eliminación no tiene vuelta atrás.

• Comment ID: el comentario que se retira, guardado del paso que lo creó o leído con comment.getAll.

Lee los comentarios de una tarea, una lista o una vista y los devuelve como items que el nodo siguiente puede recorrer.

• Comments On: el tipo de objeto leído, task, list o view.
• ID: el identificador de ese objeto.
• Limit: el número máximo de comentarios que vuelven, útil cuando un hilo lleva meses abierto.

Reescribe un comentario existente en su sitio, lo pasa a otra persona o lo marca como resuelto.

• Comment ID: el comentario que se edita.
• Comment Text: dentro de Update Fields, el nuevo contenido.
• Resolved: dentro de Update Fields, marca el hilo como atendido.
• Assignee ID: dentro de Update Fields, mueve el comentario a otro usuario de ClickUp.

Crea una carpeta dentro de un espacio, el contenedor que luego guardará las listas de un proyecto.

• Team Name or ID: el espacio de trabajo. Los campos que llevan Name or ID leen los valores de tu cuenta y los muestran en una lista, y admiten también un identificador pasado con una expresión.
• Space Name or ID: el espacio que recibe la carpeta.
• Name: el nombre de la carpeta, normalmente la referencia del proyecto.

Elimina una carpeta de su espacio. Los tres campos de ubicación tienen que describir el mismo camino: equipo, espacio y carpeta.

• Team Name or ID y Space Name or ID: dónde vive la carpeta ahora mismo.
• Folder Name or ID: la carpeta que se borra, elegida en la lista o pasada como identificador.

Devuelve una sola carpeta, que es la forma más rápida de comprobar que existe antes de escribir nada dentro.

• Team Name or ID y Space Name or ID: el camino hasta la carpeta.
• Folder Name or ID: la carpeta que se lee.

Lista las carpetas de un espacio y devuelve un item por carpeta, con las archivadas dentro o fuera según el filtro.

• Space Name or ID: el espacio que se inspecciona, dentro del equipo elegido arriba.
• Limit: el techo de carpetas devueltas.
• Archived: dentro de Filters, el booleano que decide si las archivadas también vuelven.

Cambia el nombre de una carpeta. Es el único campo que esta operación toca, lo demás sigue igual.

• Folder Name or ID: la carpeta que se renombra, dentro del equipo y el espacio indicados.
• Name: dentro de Update Fields, el nombre nuevo.

Abre un objetivo en el espacio de trabajo, con sus responsables, su color y su fecha límite. Los resultados clave llegan después, con su propia operación.

• Team Name or ID: el equipo al que pertenece el objetivo.
• Name: el objetivo, redactado como resultado y no como tarea.
• Due Date: dentro de Additional Fields, la fecha contra la que se mide.
• Owners y Multiple Owners: dentro de Additional Fields, quién lo lleva, una persona o varias.

Retira un objetivo del espacio de trabajo. La operación no pide más que su identificador, guardado del paso que lo creó o de un listado.

• Goal ID: el objetivo que se elimina.

Lee un objetivo y lo devuelve como un item único, que es lo que necesitas antes de decidir si hay que actualizarlo. No escribe nada, así que es la mitad tranquila de un par leer y escribir.

• Goal ID: el objetivo que se lee.

Lista los objetivos de un espacio de trabajo, un item por objetivo, listos para filtrarlos o contarlos más adelante en el flujo.

• Team Name or ID: el equipo cuyos objetivos se listan.
• Limit: el número máximo de objetivos devueltos, útil en un espacio que acumula años de planes.

Edita un objetivo que ya existe: nombre, descripción, fecha límite, color y la gente que lo lleva, que entra y sale por dos campos separados.

• Goal ID: el objetivo que se edita.
• Due Date: dentro de Update Fields, la nueva fecha límite.
• Add Owners y Remove Owners: dentro de Update Fields, las altas y las bajas se tratan por separado.

Cuelga un resultado medible de un objetivo. El tipo elegido decide qué se cuenta.

• Goal ID y Name: el objetivo al que se engancha y qué se mide.
• Type: uno entre automatic, boolean, currency, number y percentage.
• Steps Start y Steps End: dentro de Additional Fields, obligatorios para los tipos Percentage, Automatic, Number y Currency, fijan el recorrido.
• Unit: dentro de Additional Fields, solo cuenta para Number y Currency, y en Currency tiene que ser un código de divisa válido.

Desengancha un resultado clave de su objetivo y lo elimina. El objetivo se queda donde estaba.

• Key Result ID: el resultado clave que se retira, que no es el identificador del objetivo.

Hace avanzar un resultado clave existente o corrige su descripción. Es la operación que más llama un flujo programado, porque una cifra se mueve mucho más que un objetivo.

• Key Result ID: el resultado clave que se actualiza.
• Steps Current: dentro de Update Fields, el valor alcanzado hasta ahora.
• Steps End y Steps Start: dentro de Update Fields, el recorrido, para el día en que se revisa la meta.
• Note: dentro de Update Fields, una nota sobre el cambio, que vale oro cuando la cifra baja.

La operación crea una lista dentro de una carpeta de ClickUp y devuelve su identificador, que los nodos siguientes reutilizan para colocar tareas.

• Space Name or ID: el espacio que aloja la lista, elegido en el desplegable o calculado con una expresión, es decir un valor leído del nodo anterior, por ejemplo {{ $json.space }}.
• Folderless List: apagado, la lista cae en la carpeta elegida justo debajo.
• Name: el título de la lista, único texto obligatorio aquí.
• Priority: dentro de Additional Fields, un entero: 1 Urgent, 2 High, 3 Normal, 4 Low.

En ClickUp los campos personalizados se declaran lista por lista. Leerlos devuelve su definición, así el flujo sabe a qué identificador escribir antes de tocar una tarea.

• Team Name or ID: el espacio de trabajo, tomado del desplegable o fijado con una expresión.
• List Name or ID: la lista cuyos campos quieres; el menú se llena cuando el espacio y la carpeta ya están elegidos.

Borrar una lista la saca del espacio junto con lo que contiene. El nodo espera un identificador, nunca un nombre, y no pide confirmación.

• List ID: aquí es un campo de texto, casi siempre {{ $json.id }} heredado de una operación anterior.
• Folderless List: el interruptor sigue contando, porque indica dónde buscar la lista.

Una lista, una lectura. La operación devuelve la ficha que ClickUp guarda: título, contenido, fechas, estados y carpeta de la que cuelga.

• List ID: el identificador de la lista que se lee, en texto.
• Folder Name or ID: la carpeta donde n8n va a buscar, elegida en el desplegable.

Todas las listas de una carpeta llegan en una sola llamada, cada una con su identificador y sus fechas.

• Folder Name or ID: la carpeta que se recorre.
• Limit: el número máximo de listas devueltas en una ejecución.
• Archived: dentro de Filters, el interruptor que decide si las listas archivadas entran en el resultado.

La pertenencia se lee a nivel de lista. La operación devuelve a las personas con acceso, con el identificador que esperan las demás operaciones de ClickUp.

• List ID: la lista que se inspecciona, escrita o construida con una expresión.
• Return All: activado, n8n recorre todas las páginas de miembros; apagado, solo llegan los primeros.

Una lista existente se actualiza aquí. Solo cambia lo que pones en Update Fields; el resto se queda como estaba.

• List ID: la lista que se modifica.
• Name: dentro de Update Fields, el título nuevo.
• Unset Status: dentro de Update Fields, quita el estado puesto en la lista.
• Priority: la misma correspondencia que al crearla, de 1 Urgent a 4 Low.

Una etiqueta pertenece al espacio, no a la tarea. La operación la declara con los dos colores que la hacen legible en una tarjeta.

• Space ID: el espacio donde se crea la etiqueta, en texto.
• Name: el rótulo, y la grafía exacta que taskTag.add pedirá después.
• Foreground Color: el color del texto, elegido en el selector.
• Background Color: el fondo que va detrás del rótulo.

La etiqueta desaparece del espacio. Las tareas que la llevaban siguen donde están, solo pierden el rótulo.

• Space ID: el espacio donde vive la etiqueta.
• Name or ID: la etiqueta que se quita, seleccionada en la lista que n8n carga de ese espacio.

El inventario de etiquetas de un espacio llega de una vez, con nombres y colores.

• Space ID: el espacio que se lee.
• Return All: marcado, vuelven todas las etiquetas, sean las que sean.
• Limit: el tope cuando Return All queda sin marcar.

Una etiqueta cambia de nombre o de colores aquí. La operación pide la etiqueta tal como existe hoy y los valores nuevos al lado.

• Name or ID: la etiqueta que se modifica, tomada de la lista del espacio.
• New Name: el nombre que se le pone.
• Foreground Color: el color de texto que se aplica.
• Background Color: el color de fondo que se aplica.

La tarea aparece en la lista elegida y sale con su identificador, que todas las operaciones de ClickUp posteriores del flujo pueden reutilizar.

• List Name or ID: la lista que recibe la tarea, al final de la cadena equipo, espacio y carpeta.
• Name: el título de la tarea.
• Custom Fields JSON: dentro de Additional Fields, valores con el formato [ {"id": "", "value": ""} ].
• Time Estimate: dentro de Additional Fields, una estimación expresada en minutos.

Un identificador, un efecto: la tarea sale de ClickUp. Esta operación no tiene colección opcional, no hay nada más que ajustar y desde el flujo no hay vuelta atrás.

• Task ID: la tarea que se borra, a menudo {{ $json.id }} que llega del nodo anterior.

Lectura de una sola tarea, con dos interruptores que cambian lo que trae la respuesta.

• Task ID: la tarea que se lee.
• Include Subtasks: activado, las subtareas vuelven junto a ella.
• Include Markdown Description: activado, la respuesta incluye markdown_description, que conserva los enlaces y el formato de la descripción.

Las tareas de una lista llegan por páginas, y la colección Filters es la que hace la selección de verdad.

• List Name or ID: la lista que se recorre.
• Return All: activado, n8n sigue las páginas hasta agotar la lista.
• Include Closed: dentro de Filters, las tareas cerradas quedan fuera mientras este interruptor esté apagado y no se envíe ningún filtro de estado.
• Order By: dentro de Filters, ordena por id, created, updated o dueDate.

¿Quién trabaja en esta tarea? La operación devuelve los miembros que ClickUp muestra en la tarjeta.

• Task ID: la tarea que se inspecciona.
• Limit: el número máximo de miembros devueltos cuando Return All queda sin marcar.

La operación escribe un valor en un campo personalizado de una tarea. El campo se señala por su identificador, el que devolvió la lectura de campos de la lista.

• Task ID: la tarea que lleva el campo.
• Field ID: el identificador del campo personalizado que se rellena.
• Value: el valor que se pone.
• Value Is JSON: actívalo cuando el campo espera un array, las etiquetas por ejemplo, para que n8n analice el valor en lugar de mandarlo como texto.

Modificación sobre la marcha. Todo lo opcional vive en Update Fields, y lo que dejas vacío conserva su valor actual.

• Task ID: la tarea que se modifica.
• Add Assignees: identificadores de responsables, separados por coma cuando hay varios.
• Remove Assignees: el mismo formato, para quienes salen de la tarea.
• Status: a diferencia del campo equivalente en la creación, aquí no hay lista desplegable, el estado se escribe como texto exacto, tal como aparece en ClickUp.

Declarar que una tarea espera a otra se hace aquí. ClickUp conoce entonces el orden y el flujo no tiene que guardarlo en una variable.

• Task ID: la tarea que espera.
• Depends On Task ID: la que debe avanzar primero.

El vínculo entre dos tareas se rompe y cada una vuelve a ser independiente. Los mismos identificadores que al crearlo, en el mismo orden.

• Task ID: la tarea que estaba esperando.
• Depends On Task ID: aquella a la que esperaba.

Una tarea puede vivir en varias listas. La operación engancha una tarea existente a una lista más, sin moverla ni duplicarla.

• Task ID: la tarea que se engancha.
• List ID: la lista que la recibe.

La tarea sale de una sola lista, la que señalas, y sigue en las demás donde figura. Aquí no se borra nada, solo salta el vínculo entre esa tarea y esa lista.

• Task ID: la tarea que se desengancha.
• List ID: la lista que abandona.

Una etiqueta que ya existe en el espacio se pone sobre una tarea, por su nombre.

• Tag Name: la etiqueta escrita igual que en el espacio.
• Custom Task IDs: dentro de Additional Fields, permite apuntar a la tarea por su identificador personalizado en lugar del de ClickUp.
• Team Name or ID: dentro de Additional Fields, solo se lee cuando Custom Task IDs está activo.

Se quita una sola etiqueta y las demás siguen puestas en la tarea.

• Task ID: la tarea que se limpia.
• Tag Name: la etiqueta que se quita, con la misma grafía que en el espacio.
• Custom Task IDs: dentro de Additional Fields, el interruptor que hace leer un identificador de tarea personalizado.

Guarda en una lista un tiempo ya trabajado, con su punto de partida y su duración.

• Start y Duration (Minutes): cuándo empezó el trabajo y cuánto duró, contado en minutos.
• Folderless List: indica si la lista de destino está fuera de una carpeta, mientras Space Name or ID, Folder Name or ID y List Name or ID completan la ruta dentro de Team Name or ID.
• Additional Fields: reúne Billable, Description, Assignee Name or ID y Tag Names or IDs.

Borra una entrada de la hoja de horas y no hay vuelta atrás. Solo cuenta su identificador, da igual en qué lista se había registrado ese tiempo.

• Time Entry ID: el identificador de la entrada, pegado a mano o leído del item de entrada con una expresión como {{ $json.id }} (una expresión es la fórmula que busca un valor en los datos que llegan).
• Team Name or ID: el espacio de trabajo donde vive esa entrada.

Lee una entrada concreta y devuelve sus valores guardados, útil para comprobar una duración antes de seguir.

• Running: activado, el nodo devuelve solo el cronómetro que está corriendo.
• Time Entry ID: el identificador de la entrada que se quiere consultar.
• Team Name or ID: el espacio de trabajo donde se hace la consulta.

Las entradas se acumulan rápido en un espacio con varios equipos. Esta operación las trae por ventana de fechas, una por item, listas para sumar.

• Filters: contiene Start Date y End Date, los dos límites del periodo que se pide.
• Return All: activado, n8n recorre las páginas de la API hasta la última entrada; desactivado, Limit fija cuántos items vuelven.
• Team Name or ID: el espacio de trabajo cuya hoja de horas se lee.

Pone en marcha un cronómetro sobre una tarea: el tiempo corre dentro de ClickUp hasta que otra operación lo para.

• Task ID: aquí es un campo de texto, no un desplegable, así que el identificador de la tarea se escribe o se toma del item que disparó el flujo.
• Additional Fields: Description explica qué cubre el cronómetro y Billable lo marca como tiempo de cliente desde el primer minuto.
• Team Name or ID: el espacio de trabajo al que pertenece.

Aquí no hay identificador que pasar: la operación para el cronómetro que esté corriendo en el espacio de trabajo y deja intacto el resto de la hoja de horas.

• Team Name or ID: el único campo que se rellena, lo que convierte esta operación en una de las más rápidas de montar.

Reescribe una entrada ya guardada: duración equivocada, tiempo puesto en la tarea que no era, casilla de facturable olvidada.

• Time Entry ID y Archived: la entrada que se corrige y el booleano obligatorio que dice si está archivada.
• Update Fields: lo que cambia de verdad, desde Duration (Minutes) y Start hasta Task Name or ID, Assignee Name or ID, Billable, Description y Tag Names or IDs.
• List Name or ID: a qué lista pertenece, vía Space Name or ID, Folderless List y Folder Name or ID.

Pega uno o varios tags a entradas que ya existen, para ordenar el tiempo más tarde sin tocar las tareas.

• Time Entry IDs: el plural es intencionado, varios identificadores caben en una sola llamada y todas esas entradas reciben los mismos tags.
• Tags: una colección donde cada fila Add Tag describe un tag que se aplica.
• Team Name or ID: el espacio de trabajo de esas entradas.

Ordenar el tiempo por tag solo funciona si todo el equipo usa las mismas etiquetas. Esta operación lista las que ya existen en el espacio de trabajo.

• Return All: trae la lista entera recorriendo las páginas; sin él, Limit decide cuántos tags vuelven.
• Team Name or ID: el espacio de trabajo cuyos tags se leen.

Quita tags de las entradas sin tocar el tiempo registrado en ellas.

• Tag Names or IDs: los tags que se sueltan, elegidos de la lista o dados por identificador con una expresión.
• Time Entry IDs: las entradas que se limpian, varias a la vez.
• Team Name or ID: el espacio de trabajo implicado.