Trello

Descripción

Los nodos Trello conectan tus workflows con Trello a través de su API REST v1 (https://api.trello.com/1). Con ellos automatizás un tablero: crear una tarjeta cuando entra un pedido, moverla de lista cuando cambia un estado, dejar el avance como comentario o listar las tarjetas de una lista para procesarlas una por una.

Hay seis nodos, uno por operación. Todos trabajan sobre tarjetas; los tableros, las etiquetas y las listas en sí no están cubiertos por estos nodos (para esos endpoints usá el nodo HTTP).

Operaciones

Crear tarjeta Crea una tarjeta en una lista.

Leer tarjeta Lee una tarjeta por su id.

Actualizar tarjeta Cambia campos, mueve de lista o archiva.

Listar tarjetas Lista todas las tarjetas de una lista.

Borrar tarjeta Elimina una tarjeta de forma permanente.

Comentar tarjeta Publica un comentario en la tarjeta.

Configuración

Nodo	Nombre interno	Endpoint utilizado
Trello: Crear tarjeta	`trelloCreateCard`	`POST /cards`
Trello: Leer tarjeta	`trelloGetCard`	`GET /cards/{id}`
Trello: Actualizar tarjeta	`trelloUpdateCard`	`PUT /cards/{id}`
Trello: Listar tarjetas	`trelloListCards`	`GET /lists/{idList}/cards`
Trello: Borrar tarjeta	`trelloDeleteCard`	`DELETE /cards/{id}`
Trello: Comentar tarjeta	`trelloAddComment`	`POST /cards/{id}/actions/comments`

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: trello. Creala en Credenciales → Agregar → Trello.

Campo	Tipo	Obligatorio	Descripción
`api_key`	texto	Sí	Tu API key de Trello, desde trello.com/app-key (Power-Up admin).
`token`	contraseña	Sí	Token generado al autorizar esa API key (el enlace Token en la misma página). Nunca se muestra en los logs.

Trello se autentica con key + token enviados como parámetros de query en cada petición: no hay flujo OAuth ni cabecera bearer. El botón Test verifica la credencial contra GET /members/me.

Los ids: de dónde salen

En Trello todo se referencia por id —cadenas hexadecimales de 24 caracteres—, nunca por nombre:

id de lista (idList): hace falta para crear o listar tarjetas. Lo obtenés con el nodo HTTP sobre GET /boards/{idBoard}/lists, o agregando .json a la URL del tablero en el navegador.
id de tarjeta: lo devuelven Crear tarjeta y Listar tarjetas, en el campo id.
ids de miembros: hacen falta para asignar una tarjeta. GET /boards/{idBoard}/members los devuelve.

Mover y archivar tarjetas

No existe un nodo aparte para “mover”: mover es una actualización.

Para mover una tarjeta a otra columna, usá Actualizar tarjeta con {"idList": "<id de la lista destino>"}.
Para archivarla sin destruirla, usá Actualizar tarjeta con {"closed": true}.
Borrar tarjeta es permanente y no se puede deshacer.

Salida

Cada nodo devuelve la respuesta de Trello tal cual en data (Trello envía JSON plano, sin envoltorio), más un bloque _meta con la versión del módulo, el id afectado y el tiempo transcurrido.

{
  "data": {
    "id": "66cd34ef56ab78cd90ef12ab",
    "name": "Pedido: ACME S.A.",
    "shortUrl": "https://trello.com/c/AbCdEfGh",
    "idList": "66ab12cd34ef56ab78cd90ef",
    "closed": false
  },
  "_meta": {
    "moduleVersion": "1.0.0",
    "success": true,
    "id": "66cd34ef56ab78cd90ef12ab",
    "url": "https://trello.com/c/AbCdEfGh",
    "totalMs": 412
  }
}

API utilizada

Trello REST API v1 — https://developer.atlassian.com/cloud/trello/rest/

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	Trello devuelve el motivo en texto plano (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 ese tablero. Revisá la credencial.
Límite de tasa (429)	Sí	Se respeta la cabecera `Retry-After` de Trello y se reintenta.
Servidor (500+)	Sí	Error temporal de Trello; 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 (abcd…wxyz).
Las variables dinámicas ({{data.campo}}) se resuelven en los campos de texto de cada nodo. El campo JSON de Actualizar tarjeta no se procesa: poné ahí valores literales, o armá el JSON en un nodo anterior.

Ver también

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