Monday.com - Crear ítem

↩ Parte de la integración Monday.com.

Descripción

Este módulo crea un ítem en un tablero enviando la mutation GraphQL create_item a https://api.monday.com/v2:

mutation($board_id: ID!, $group_id: String, $item_name: String!, $column_values: JSON) {
  create_item(board_id: $board_id, group_id: $group_id, item_name: $item_name, column_values: $column_values) {
    id
    name
  }
}

Vos solo completás los campos; el nodo arma la mutation y las variables. column_values se convierte a cadena JSON antes de enviarse, tal como exige la API de Monday.

Configuración

Campo	Tipo	Obligatorio	Descripción
`credentials_id`	credentials	Sí	Credencial de Monday
`board_id`	text	Sí	ID numérico del tablero
`group_id`	text	No	ID del grupo dentro del tablero
`item_name`	text	Sí	Nombre del ítem
`column_values`	json	No	Valores de columnas como JSON

Credenciales

Este módulo requiere una credencial de tipo Monday.

Campo	Descripción
`token`	Token personal de la API (Avatar → Developers → My access tokens)
`timeout`	Opcional. Tiempo máximo de la petición en milisegundos (por defecto 20000)

Salida

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

La mutation solo le pide a Monday id y name, así que esos son los dos campos que recibís. Encadená un nodo Leer ítem si después necesitás la fila completa.

Ejemplo de uso

Ítem mínimo

{
  "credentials_id": 8,
  "board_id": "1234567890",
  "item_name": "{{data.empresa}}"
}

Ítem en un grupo, con valores de columnas

{
  "credentials_id": 8,
  "board_id": "1234567890",
  "group_id": "nuevos_leads",
  "item_name": "{{data.empresa}}",
  "column_values": {
    "status":  { "label": "Nuevo" },
    "email":   { "email": "{{data.email}}", "text": "{{data.email}}" },
    "date4":   { "date": "2026-03-05" },
    "numbers": "4200"
  }
}

Notas

Las claves de column_values son ids de columna, no los títulos que se ven en el tablero. Podés leerlos con una llamada a Leer ítem o desde el menú de la columna en Monday.
Si omitís group_id, el ítem cae en el grupo por defecto del tablero (el de más arriba).
Monday devuelve HTTP 200 incluso cuando la mutation falla. El nodo revisa el array errors y corta la rama con el mensaje real, por ejemplo ColumnValueException cuando un valor no encaja con el tipo de columna.
Un valor de column_values con la forma equivocada es un error de validación y no se reintenta. Corregí el JSON y volvé a ejecutar.
board_id e item_name son obligatorios. Si falta alguno, el nodo falla antes de llamar a Monday.

Nodos relacionados

Monday.com - Leer ítem — leé el ítem que acabás de crear.
Monday.com - Actualizar ítem — cambiá después sus valores de columnas.
Monday.com - Agregar update — publicá un comentario en el ítem nuevo.