ClickUp

Descripción

Los nodos ClickUp conectan tus workflows con ClickUp a través de su API REST v2 (https://api.clickup.com/api/v2). Con ellos automatizás la gestión de tareas: abrir 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. Todos trabajan sobre tareas, que en ClickUp siempre viven dentro de una lista.

Operaciones

Crear tarea Crea una tarea en una lista.

Leer tarea Lee una tarea por su id.

Actualizar tarea Cambia estado, nombre, fechas o campos.

Listar tareas Lista las tareas de una lista, con paginación.

Borrar tarea Elimina una tarea de forma permanente.

Comentar tarea Publica un comentario y notifica a los asignados.

Configuración

Nodo	Nombre interno	Endpoint utilizado
ClickUp: Crear tarea	`clickupCreateTask`	`POST /list/{list_id}/task`
ClickUp: Leer tarea	`clickupGetTask`	`GET /task/{task_id}`
ClickUp: Actualizar tarea	`clickupUpdateTask`	`PUT /task/{task_id}`
ClickUp: Listar tareas	`clickupListTasks`	`GET /list/{list_id}/task`
ClickUp: Borrar tarea	`clickupDeleteTask`	`DELETE /task/{task_id}`
ClickUp: Comentar tarea	`clickupAddComment`	`POST /task/{task_id}/comment`

Todos los nodos piden un campo credentials_id más los parámetros propios de su operación. La tabla exacta de cada uno está en su página.

Credenciales

Tipo de servicio: clickup. Creala en Credenciales → Agregar → ClickUp.

Campo	Tipo	Obligatorio	Descripción
`token`	contraseña	Sí	Personal API token desde ClickUp → Settings → Apps → API Token (empieza con `pk_`). Nunca se muestra en los logs.

El token viaja en la cabecera Authorization tal cual, sin el prefijo Bearer, que es lo que espera ClickUp y una causa frecuente de errores 401 cuando se copia el valor desde otras herramientas. El botón Test verifica la credencial contra GET /user.

Ids, fechas y prioridad

id de lista (list_id): el número que ves en la URL al abrir una lista en ClickUp (.../v/li/901300123456). También podés recorrer espacios → carpetas → listas con el nodo HTTP.
id de tarea (task_id): lo devuelven Crear tarea y Listar tareas en el campo id (ej. 86a1b2c3d).
Las fechas (due_date, start_date) son timestamps Unix en milisegundos: un número, no un texto ISO. 2026-08-15T10:00:00Z equivale a 1786788000000.
La prioridad es un número: 1 urgente, 2 alta, 3 normal, 4 baja.
Los estados son propios de cada lista: el valor que envíes tiene que existir ya en el flujo de esa lista o ClickUp lo rechaza.

Salida

Cada nodo devuelve la respuesta de ClickUp en data, más un bloque _meta con la versión del módulo, el id afectado y el tiempo transcurrido.

{
  "data": {
    "id": "86a1b2c3d",
    "name": "Pedido: ACME S.A.",
    "status": { "status": "to do", "type": "open" },
    "url": "https://app.clickup.com/t/86a1b2c3d"
  },
  "_meta": {
    "moduleVersion": "1.0.0",
    "success": true,
    "id": "86a1b2c3d",
    "url": "https://app.clickup.com/t/86a1b2c3d",
    "totalMs": 388
  }
}

API utilizada

ClickUp API v2 — https://clickup.com/api

Manejo de errores

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

Situación	Reintentable	Qué hacer
Validación (400)	No	ClickUp devuelve `{"err": "...", "ECODE": "..."}` — por ejemplo, un estado que no existe en la lista. 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, token enviado con prefijo `Bearer`, o sin acceso a ese espacio. Revisá la credencial.
Límite de tasa (429)	Sí	Se respeta la cabecera `Retry-After` de ClickUp y se reintenta.
Servidor (500+)	Sí	Error temporal de ClickUp; se reintenta automáticamente.
Red / timeout	Sí	Problema pasajero; se reintenta automáticamente.

Notas

Timeout de la petición: 20 segundos. Los fallos reintentables se reintentan hasta 3 veces con backoff exponencial.
El token nunca se escribe en los logs: solo un fragmento enmascarado (pk_1…wxyz).
Las variables dinámicas ({{data.campo}}) se resuelven en los campos de texto de cada nodo. Los campos JSON (el fields de Actualizar tarea y el assignees de Crear tarea) no se procesan: poné ahí valores literales, o armá el JSON en un nodo anterior.

Ver también

Trello — la integración equivalente para tarjetas de Trello.
Jira, Asana, Notion y Monday — otras integraciones de gestión de trabajo.
Nodo HTTP — para endpoints de ClickUp no cubiertos por estos nodos (espacios, carpetas, listas, seguimiento de tiempo…).
Cola de reintentos (DLQ) — cómo se reintentan las ejecuciones que fallan.