Monday.com

Descripción

Integración con la API de Monday.com, que es GraphQL y no REST. Cada operación es un POST al endpoint único https://api.monday.com/v2 con un cuerpo { query, variables }. Los nodos arman esa consulta por vos; el nodo Query GraphQL te deja escribir la tuya cuando necesitás algo que los otros cinco no cubren.

Cinco nodos envuelven las operaciones cotidianas sobre ítems —crear, leer, actualizar, borrar y publicar un update— y el sexto es una salida de emergencia con GraphQL crudo.

La autenticación se resuelve mediante el módulo de credenciales (tipo de servicio monday). Las peticiones envían además la cabecera API-Version con el valor 2024-10.

Operaciones

Crear ítem Creá un ítem en un tablero, con valores de columnas.

Leer ítem Leé un ítem y todos sus valores de columnas.

Actualizar ítem Cambiá los valores de columnas de un ítem.

Borrar ítem Borrá un ítem por su id.

Agregar update Publicá un update (comentario) en un ítem.

Query GraphQL Ejecutá cualquier query o mutation cruda.

Configuración

Cada nodo muestra solo los campos que necesita. Esta es la lista combinada de los seis:

Parámetro	Tipo	Obligatorio	Descripción
credentials_id	credentials	Sí	Credencial de Monday (proveedor `monday`)
board_id	text	Condicional	ID numérico del tablero: Crear ítem y Actualizar ítem
group_id	text	No	ID del grupo dentro del tablero: Crear ítem
item_name	text	Condicional	Nombre del ítem: Crear ítem
item_id	text	Condicional	ID numérico del ítem: Leer, Actualizar, Borrar y Agregar update
column_values	json	Condicional	Valores de columnas como JSON, que se envía a Monday como JSON stringificado
body	textarea	Condicional	Texto del update: Agregar update
query	textarea	Condicional	Query o mutation GraphQL: Query GraphQL
variables	json	No	Variables de la operación: Query GraphQL

Credenciales

Tipo de servicio: monday. Se guardan en la tabla servicecredentials.

token: token personal de la API, que se genera en Monday desde Avatar → Developers → My access tokens (o Admin → API). Obligatorio.
timeout: tiempo máximo de la petición en milisegundos (por defecto: 20000). Opcional.

El token viaja en la cabecera Authorization tal cual, sin el prefijo Bearer: es una particularidad de Monday. El botón Test ejecuta la consulta { me { name } } y devuelve el nombre de la cuenta.

Valores de columnas

column_values es la parte más delicada de la API de Monday: tiene que llegar como JSON stringificado, no como objeto. Vos lo escribís como JSON normal en el nodo y Floogos lo convierte a cadena antes de enviarlo.

Las claves son ids de columna, no los títulos que ves en el tablero, y la forma del valor depende del tipo de columna:

{
  "status":       { "label": "En curso" },
  "date4":        { "date": "2026-03-05" },
  "person":       { "personsAndTeams": [ { "id": 12345678, "kind": "person" } ] },
  "numbers":      "4200",
  "text":         "Texto libre"
}

Salida

{
  "nextModule": null,
  "data": { "id": "987654321", "name": "Acme S.A." },
  "_meta": {
    "moduleVersion": "1.0.0",
    "success": true,
    "id": "987654321",
    "totalMs": 310
  }
}

API utilizada

API GraphQL de Monday.com — https://developer.monday.com/api-reference
Endpoint: POST https://api.monday.com/v2, versión de API 2024-10
Operaciones: create_item, items, change_multiple_column_values, delete_item, create_update

Notas

Los ids de tablero y de ítem son numéricos, y el esquema GraphQL los tipa como ID!. Los nodos los convierten a cadena antes de enviarlos, así que podés alimentarlos desde un nodo anterior sin preocuparte.
Todos los campos de texto e id aceptan variables dinámicas como {{data.item_id}}, también dentro de los campos JSON.
Los fallos transitorios (timeout, límite de peticiones, 5xx y errores de red) se reintentan automáticamente hasta 3 veces con espera exponencial, respetando Retry-After y el retry_in_seconds de Monday.
El límite de peticiones de Monday se basa en la complejidad, no en el número de llamadas. Los errores cuyo código GraphQL menciona complejidad o límites por minuto o por día se tratan como límite de peticiones y se reintentan.
Los errores de autenticación y los de validación —tablero inválido, columna inexistente, argumento incorrecto— no se reintentan.
El tiempo máximo de la petición es de 20 segundos por defecto.

Nodos relacionados

HubSpot y Salesforce — otras integraciones de CRM.
Jira, Asana, Trello y ClickUp — integraciones de gestión del trabajo.
Cola de reintentos (DLQ) — cómo se reintentan las ejecuciones fallidas.