Monday.com - Create Item

↩ Part of the Monday.com integration.

Description

This module creates an item in a board by sending the create_item GraphQL mutation to 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
  }
}

You only fill the fields; the node builds the mutation and the variables. column_values is stringified to JSON before being sent, as the Monday API requires.

Configuration

Field	Type	Required	Description
`credentials_id`	credentials	Yes	Monday credential
`board_id`	text	Yes	Numeric board id
`group_id`	text	No	Group id inside the board
`item_name`	text	Yes	Item name
`column_values`	json	No	Column values as JSON

Credentials

This module requires a Monday credential.

Field	Description
`token`	Personal API token (Avatar → Developers → My access tokens)
`timeout`	Optional. Request timeout in milliseconds (default 20000)

Output

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

The mutation only asks Monday for id and name, so those are the two fields you get back. Chain a Get Item node if you need the full row afterwards.

Usage Example

Minimal item

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

Item in a group, with column values

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

Notes

The keys inside column_values are column ids, not the titles shown in the board. You can read them from a Get Item call, or from the board’s column menu in Monday.
If you omit group_id, the item lands in the board’s default (topmost) group.
Monday returns HTTP 200 even when the mutation fails. The node inspects the errors array and stops the branch with the real message, for example ColumnValueException when a value does not match the column type.
A column_values value with the wrong shape for its column type is a validation error and is not retried. Fix the JSON and run again.
Both board_id and item_name are required. If either is missing the node fails before calling Monday.

Monday.com - Get Item — read the item you just created.
Monday.com - Update Item — change its column values later.
Monday.com - Add Update — post a comment on the new item.