Trello

Descripción

Los nodos Trello conectan tus workflows con Trello a través de su API REST v1. Con ellos podés automatizar tu tablero: crear una tarjeta cuando entra un pedido, moverla de lista cuando cambia un estado, comentar el avance, o listar las tarjetas de una lista para procesarlas.

Hay seis nodos, uno por operación:

Nodo	Operación	Método HTTP
Trello: Crear tarjeta (`trelloCreateCard`)	Crea una tarjeta en una lista	`POST /cards`
Trello: Leer tarjeta (`trelloGetCard`)	Lee una tarjeta por su id	`GET /cards/{id}`
Trello: Actualizar tarjeta (`trelloUpdateCard`)	Actualiza campos (incluye mover/archivar)	`PUT /cards/{id}`
Trello: Borrar tarjeta (`trelloDeleteCard`)	Borra una tarjeta	`DELETE /cards/{id}`
Trello: Comentar tarjeta (`trelloAddComment`)	Agrega un comentario	`POST /cards/{id}/actions/comments`
Trello: Listar tarjetas (`trelloListCards`)	Lista las tarjetas de una lista	`GET /lists/{idList}/cards`

Credencial

Los nodos usan una credencial de tipo Trello. Creala en Credenciales → Agregar → Trello con estos campos:

Campo	Descripción
API key	Tu API key de Trello, desde trello.com/app-key.
Token	El token que generás al autorizar tu API key (link Token en la misma página). Nunca se muestra en logs.

La autenticación de Trello usa key + token enviados en cada petición. Podés probar la credencial con el botón Test, que llama a GET /members/me y confirma el usuario.

Nota importante: ids y mover tarjetas

En Trello todo se referencia por id (strings de 24 caracteres): la lista (idList), la tarjeta, los miembros. El id de una lista lo obtenés, por ejemplo, con el nodo HTTP sobre GET /boards/{idBoard}/lists, o desde la URL/atajos de Trello.
Para mover una tarjeta de columna no hay un nodo aparte: usá Trello: Actualizar tarjeta e incluí idList (el id de la lista destino) en el JSON de campos. Para archivar una tarjeta sin borrarla, poné {"closed": true}.

Nodos

Trello: Crear tarjeta (`trelloCreateCard`)

Parámetro	Tipo	Requerido	Descripción
credentials_id	credencial	Sí	Credencial de Trello
id_list	texto	Sí	id de la lista donde crear la tarjeta
name	texto	Sí	Título de la tarjeta
desc	texto	No	Descripción
due	texto	No	Fecha límite ISO (ej. `2026-08-15T10:00:00Z`)
id_members	texto	No	ids de miembros a asignar, separados por coma
pos	texto	No	Posición: `top`, `bottom` o un número

Salida: la tarjeta creada, incluyendo su id y shortUrl.

Trello: Leer tarjeta (`trelloGetCard`)

Parámetro	Tipo	Requerido	Descripción
credentials_id	credencial	Sí	Credencial de Trello
card_id	texto	Sí	id de la tarjeta
fields	texto	No	Campos a devolver, separados por coma

Trello: Actualizar tarjeta (`trelloUpdateCard`)

Parámetro	Tipo	Requerido	Descripción
credentials_id	credencial	Sí	Credencial de Trello
card_id	texto	Sí	id de la tarjeta
fields	JSON	Sí	Campos a actualizar, ej. `{"idList":"...","closed":true}`

Trello: Borrar tarjeta (`trelloDeleteCard`)

Parámetro	Tipo	Requerido	Descripción
credentials_id	credencial	Sí	Credencial de Trello
card_id	texto	Sí	id de la tarjeta a borrar

Trello: Comentar tarjeta (`trelloAddComment`)

Parámetro	Tipo	Requerido	Descripción
credentials_id	credencial	Sí	Credencial de Trello
card_id	texto	Sí	id de la tarjeta
text	texto	Sí	Texto del comentario

Trello: Listar tarjetas (`trelloListCards`)

Parámetro	Tipo	Requerido	Descripción
credentials_id	credencial	Sí	Credencial de Trello
id_list	texto	Sí	id de la lista
limit	número	No	Máximo de tarjetas
fields	texto	No	Campos a devolver, separados por coma

Salida: el array de tarjetas de la lista.

Ejemplo

Crear una tarjeta a partir de un formulario:

Nodo: Trello: Crear tarjeta
id_list: 66ab12cd34ef56ab78cd90ef
name: Pedido: {{data.cliente}}
desc: {{data.detalle}}

Salida:

{
  "id": "66cd34ef56ab78cd90ef12ab",
  "name": "Pedido: ACME S.A.",
  "shortUrl": "https://trello.com/c/AbCdEfGh",
  "idList": "66ab12cd34ef56ab78cd90ef"
}

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	Trello devuelve el motivo (ej. `invalid value for idList`). Corregí los datos.
No encontrado (404)	No	La tarjeta o la lista no existen. Revisá el id.
Autenticación (401/403)	No	key/token inválidos o sin permiso sobre el tablero. Revisá la credencial.
Servidor (500)	Sí	Error temporal de Trello; se reintenta automáticamente.
Límite de tasa (429)	Sí	Se respeta el `Retry-After` de Trello y se reintenta.
Red / Timeout	Sí	Problema pasajero; se reintenta automáticamente.

Ver también

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