ClickUp - Crear tarea

↩ Parte de la integración ClickUp.

Descripción

Crea una tarea en una lista de ClickUp (POST /list/{list_id}/task). Es la puerta de entrada de casi toda automatización con ClickUp: se envía un formulario, entra un pedido o se detecta una incidencia, y la tarea aparece en la lista correcta con el estado y la prioridad que corresponden.

La lista destino se identifica por su id (list_id), nunca por su nombre.

Configuración

Campo	Tipo	Obligatorio	Descripción
`credentials_id`	credentials	Sí	Credencial de ClickUp
`list_id`	texto	Sí	id de la lista donde crear la tarea
`name`	texto	Sí	Nombre de la tarea
`description`	textarea	No	Descripción
`status`	texto	No	Estado (tiene que existir ya en la lista)
`priority`	número	No	`1` urgente, `2` alta, `3` normal, `4` baja
`due_date`	texto	No	Fecha límite como timestamp Unix en milisegundos
`assignees`	JSON	No	ids de usuarios asignados como array JSON, ej. `[123,456]`

list_id, name, description, status y due_date se resuelven con variables dinámicas ({{data.campo}}). priority se convierte a número y assignees se parsea como JSON: si no es JSON válido, simplemente se ignora.

Credenciales

Este nodo requiere una credencial ClickUp (tipo de servicio clickup):

Campo	Descripción
`token`	Personal API token desde ClickUp → Settings → Apps → API Token (empieza con `pk_`)

Salida

La tarea creada por ClickUp, tal como la devuelve la API:

{
  "data": {
    "id": "86a1b2c3d",
    "name": "Pedido: ACME S.A.",
    "status": { "status": "to do", "type": "open" },
    "date_created": "1786700000000",
    "due_date": "1786788000000",
    "priority": { "id": "2", "priority": "high" },
    "url": "https://app.clickup.com/t/86a1b2c3d",
    "list": { "id": "901300123456", "name": "Pedidos entrantes" }
  },
  "_meta": {
    "moduleVersion": "1.0.0",
    "success": true,
    "id": "86a1b2c3d",
    "url": "https://app.clickup.com/t/86a1b2c3d",
    "totalMs": 388
  }
}

Guardá el id: es lo que necesitan los nodos de actualizar, comentar y borrar.

Ejemplo de uso

Tarea a partir de un formulario

{
  "credentials_id": "clickup_ops",
  "list_id": "901300123456",
  "name": "Pedido: {{data.cliente}}",
  "description": "{{data.detalle}}"
}

Tarea urgente con fecha límite y asignados

{
  "credentials_id": "clickup_ops",
  "list_id": "901300123456",
  "name": "Incidencia #{{data.ticket_id}}",
  "description": "Reportada por {{data.email}}",
  "status": "to do",
  "priority": 1,
  "due_date": "1786788000000",
  "assignees": [ 4812345, 4812346 ]
}

Notas

Si list_id o name vienen vacíos, el nodo corta con un error de validation y no llama a ClickUp.
due_date son milisegundos desde el epoch Unix, no una fecha ISO. Si tenés un texto ISO, convertilo en un nodo anterior (por ejemplo con Date.parse(...) en un nodo Ejecutar script).
status tiene que coincidir con un estado configurado en esa lista; si no existe, ClickUp responde con un error de validation.
assignees recibe ids numéricos de usuario, no emails ni nombres de usuario.

Nodos relacionados

ClickUp - Actualizar tarea — cambiá el estado cuando avanza el trabajo.
ClickUp - Comentar tarea — dejá el avance en la tarea recién creada.
ClickUp - Listar tareas — mirá qué contiene ya la lista.