ClickUp

Descripción

Los nodos ClickUp conectan tus workflows con ClickUp a través de su API REST v2. Con ellos podés automatizar tu gestión de tareas: crear una tarea cuando entra un pedido, cambiarle el estado al avanzar un proceso, comentar el resultado, o listar las tareas de una lista para procesarlas.

Hay seis nodos, uno por operación:

Nodo	Operación	Método HTTP
ClickUp: Crear tarea (`clickupCreateTask`)	Crea una tarea en una lista	`POST /list/{list_id}/task`
ClickUp: Leer tarea (`clickupGetTask`)	Lee una tarea por su id	`GET /task/{task_id}`
ClickUp: Actualizar tarea (`clickupUpdateTask`)	Actualiza campos	`PUT /task/{task_id}`
ClickUp: Borrar tarea (`clickupDeleteTask`)	Borra una tarea	`DELETE /task/{task_id}`
ClickUp: Comentar tarea (`clickupAddComment`)	Agrega un comentario	`POST /task/{task_id}/comment`
ClickUp: Listar tareas (`clickupListTasks`)	Lista las tareas de una lista	`GET /list/{list_id}/task`

Credencial

Los nodos usan una credencial de tipo ClickUp. Creala en Credenciales → Agregar → ClickUp con este campo:

Campo	Descripción
Personal API token	El token personal, desde ClickUp → Settings → Apps → API Token (empieza con `pk_`). Nunca se muestra en logs.

La autenticación de ClickUp envía el token en el header Authorization tal cual (sin prefijo Bearer). Podés probar la credencial con el botón Test, que llama a GET /user.

Nota importante: ids y fechas

En ClickUp todo se referencia por id (strings): la lista (list_id), la tarea (task_id). El id de una lista lo obtenés desde la URL de la lista en ClickUp, o con el nodo HTTP sobre los endpoints de espacios/carpetas/listas.
Las fechas (due_date) van como timestamp Unix en milisegundos (número), no como texto ISO.
La prioridad es un número: 1 urgente, 2 alta, 3 normal, 4 baja.

Nodos

ClickUp: Crear tarea (`clickupCreateTask`)

Parámetro	Tipo	Requerido	Descripción
credentials_id	credencial	Sí	Credencial de ClickUp
list_id	texto	Sí	id de la lista
name	texto	Sí	Nombre de la tarea
description	texto	No	Descripción
status	texto	No	Estado (debe existir en la lista)
priority	número	No	1 urgente, 2 alta, 3 normal, 4 baja
due_date	texto	No	Timestamp Unix en milisegundos
assignees	JSON	No	ids de usuarios asignados, ej. `[123,456]`

Salida: la tarea creada, incluyendo su id y url.

ClickUp: Leer tarea (`clickupGetTask`)

Parámetro	Tipo	Requerido	Descripción
credentials_id	credencial	Sí	Credencial de ClickUp
task_id	texto	Sí	id de la tarea

ClickUp: Actualizar tarea (`clickupUpdateTask`)

Parámetro	Tipo	Requerido	Descripción
credentials_id	credencial	Sí	Credencial de ClickUp
task_id	texto	Sí	id de la tarea
fields	JSON	Sí	Campos a actualizar, ej. `{"status":"in progress"}`

ClickUp: Borrar tarea (`clickupDeleteTask`)

Parámetro	Tipo	Requerido	Descripción
credentials_id	credencial	Sí	Credencial de ClickUp
task_id	texto	Sí	id de la tarea a borrar

ClickUp: Comentar tarea (`clickupAddComment`)

Parámetro	Tipo	Requerido	Descripción
credentials_id	credencial	Sí	Credencial de ClickUp
task_id	texto	Sí	id de la tarea
comment_text	texto	Sí	Texto del comentario
notify_all	texto	No	`true` para notificar a todos los asignados

ClickUp: Listar tareas (`clickupListTasks`)

Parámetro	Tipo	Requerido	Descripción
credentials_id	credencial	Sí	Credencial de ClickUp
list_id	texto	Sí	id de la lista
archived	texto	No	`true` para incluir archivadas
subtasks	texto	No	`true` para incluir subtareas
page	número	No	Página (paginación, 0-based)

Salida: el array de tareas de la lista.

Ejemplo

Crear una tarea a partir de un formulario:

Nodo: ClickUp: Crear tarea
list_id: 901300123456
name: Pedido: {{data.cliente}}
description: {{data.detalle}}
priority: 2

Salida:

{
  "id": "86a1b2c3d",
  "name": "Pedido: ACME S.A.",
  "url": "https://app.clickup.com/t/86a1b2c3d",
  "status": { "status": "to do" }
}

Manejo de errores

Cada nodo clasifica los errores para que el motor sepa si tiene sentido reintentar:

Situación	Reintentable	Qué hacer
Validación (400)	No	ClickUp devuelve el motivo (ej. estado inexistente en la lista, o list_id inválido). Corregí los datos.
No encontrado (404)	No	La tarea o la lista no existen. Revisá el id.
Autenticación (401/403)	No	Token inválido o sin permiso. Revisá la credencial.
Servidor (500)	Sí	Error temporal de ClickUp; se reintenta automáticamente.
Límite de tasa (429)	Sí	Se respeta el `Retry-After` de ClickUp (≈100 req/min) y se reintenta.
Red / Timeout	Sí	Problema pasajero; se reintenta automáticamente.

Ver también

Jira (Atlassian), Asana, Trello y Notion — otras integraciones de gestión de trabajo.
Cola de reintentos (DLQ) — cómo se reintentan las ejecuciones que fallan.
Nodo HTTP — para endpoints de ClickUp no cubiertos por estos nodos (spaces, folders, lists…).