Monday.com integration

Overview

The Monday.com tool communicates with the Monday.com work management platform via its GraphQL API (POST https://api.monday.com/v2/). It supports managing boards (create, get, get many, archive), board columns (create, get many), board groups (create, delete, get many), and board items (create, get, get many, get by column value, add update, change column value, change multiple column values, move, delete). Authentication uses either a Monday.com API token (v2) or OAuth2 access token. The API-Version header is set to 2023-10. Board listing uses page-based pagination. Item listing uses cursor-based pagination via items_page and next_items_page. JSON column values are validated before sending.

Node Type

Action — processes input items and produces output

Input / Output

Direction	Port(s)
Input	Input
Output	Output, Error

Credentials

This tool requires Monday.com credentials. See the Credentials Guide for setup instructions.

Resources

Resource	Value
Board	board
Board Column	boardColumn
Board Group	boardGroup
Board Item	boardItem

Operations

Board (board)

Operation	Value	Description
Archive	archive	Archive a board
Create	create	Create a new board
Get	get	Get a board
Get Many	getAll	Get many boards

Board Column (boardColumn)

Operation	Value	Description
Create	create	Create a new column
Get Many	getAll	Get many columns

Board Group (boardGroup)

Operation	Value	Description
Create	create	Create a group in a board
Delete	delete	Delete a group in a board
Get Many	getAll	Get many groups in a board

Board Item (boardItem)

Operation	Value	Description
Add Update	addUpdate	Add an update to an item
Change Column Value	changeColumnValue	Change a column value for a board item
Change Multiple Column Values	changeMultipleColumnValues	Change multiple column values for a board item
Create	create	Create an item in a board’s group
Delete	delete	Delete an item
Get	get	Get an item
Get By Column Value	getByColumnValue	Get items by column value
Get Many	getAll	Get many items
Move	move	Move item to group

Parameters

Board: Archive

Parameter	Type	Required	Default	Description
Board ID	string	Yes	—	The board’s unique identifier, as shown in the board’s Monday.com URL.

Board: Create

Parameter	Type	Required	Default	Description
Name	string	Yes	—	The name of the new board, group or item.
Kind	options	Yes	—	The board’s kind (public / private / share).
				Options: share, public, private
Additional Fields	collection	No	{}
— Template ID	number	No	0	Optional board template ID to clone from.

Board: Get

Parameter	Type	Required	Default	Description
Board ID	string	Yes	—	The board’s unique identifier, as shown in the board’s Monday.com URL.

Board: Get Many

Parameter	Type	Required	Default	Description
Return All	boolean	No	false	Whether to return all results or only up to a given limit.
Limit	number	No	50	Max number of results to return. (shown when Return All is false)

Board Column: Create

Parameter	Type	Required	Default	Description
Board ID	string	Yes	—	The board’s unique identifier, as shown in the board’s Monday.com URL.
Title	string	Yes	—	The title for the new column.
Column Type	options	Yes	—	The type of column to create.
				Options: checkbox, country, date, dropdown, email, hour, Link, longText, numbers, people, person, phone, rating, status, tags, team, text, timeline, timezone, week, worldClock
Additional Fields	collection	No	{}
— Defaults	json	No	—	The new column’s defaults as a JSON string.

Board Column: Get Many

Parameter	Type	Required	Default	Description
Board ID	string	Yes	—	The board’s unique identifier, as shown in the board’s Monday.com URL.

Board Group: Create

Parameter	Type	Required	Default	Description
Board ID	string	Yes	—	The board’s unique identifier, as shown in the board’s Monday.com URL.
Name	string	Yes	—	The name of the new board, group or item.

Board Group: Delete

Parameter	Type	Required	Default	Description
Board ID	string	Yes	—	The board’s unique identifier, as shown in the board’s Monday.com URL.
Group ID	string	Yes	—	The unique identifier of the target group in the board; find it by listing the board’s groups.

Board Group: Get Many

Parameter	Type	Required	Default	Description
Board ID	string	Yes	—	The board’s unique identifier, as shown in the board’s Monday.com URL.

Board Item: Add Update

Parameter	Type	Required	Default	Description
Item ID	string	Yes	—	The item’s unique identifier; for get, several separated by commas.
Update Text	string	Yes	—	The update text to add to the item.

Board Item: Change Column Value

Parameter	Type	Required	Default	Description
Board ID	string	Yes	—	The board’s unique identifier, as shown in the board’s Monday.com URL.
Item ID	string	Yes	—	The item’s unique identifier; for get, several separated by commas.
Column ID	string	Yes	—	The column’s unique identifier; find it by listing the board’s columns.
Value	json	Yes	—	The column value as a JSON string, for the single column named by Column ID. See Monday.com API docs for column value formats: https://developer.monday.com/api-reference/docs/column-values-v2

Board Item: Change Multiple Column Values

Parameter	Type	Required	Default	Description
Board ID	string	Yes	—	The board’s unique identifier, as shown in the board’s Monday.com URL.
Item ID	string	Yes	—	The item’s unique identifier; for get, several separated by commas.
Column Values	json	Yes	—	The column fields and values in JSON format (object of column_id:value pairs). See Monday.com API docs for column value formats.

Board Item: Create

Parameter	Type	Required	Default	Description
Board ID	string	Yes	—	The board’s unique identifier, as shown in the board’s Monday.com URL.
Group ID	string	Yes	—	The unique identifier of the target group in the board; find it by listing the board’s groups.
Name	string	Yes	—	The name of the new board, group or item.
Additional Fields	collection	No	{}
— Column Values	json	No	—	The column values of the new item as a JSON string.

Board Item: Delete

Parameter	Type	Required	Default	Description
Item ID	string	Yes	—	The item’s unique identifier; for get, several separated by commas.

Board Item: Get

Parameter	Type	Required	Default	Description
Item ID	string	Yes	—	The item’s unique identifier; for get, several separated by commas.

Board Item: Get By Column Value

Parameter	Type	Required	Default	Description
Board ID	string	Yes	—	The board’s unique identifier, as shown in the board’s Monday.com URL.
Column ID	string	Yes	—	The column’s unique identifier; find it by listing the board’s columns.
Column Value	string	Yes	—	The column value to search items by.
Return All	boolean	No	false	Whether to return all results or only up to a given limit.
Limit	number	No	50	Max number of results to return. (shown when Return All is false)

Board Item: Get Many

Parameter	Type	Required	Default	Description
Board ID	string	Yes	—	The board’s unique identifier, as shown in the board’s Monday.com URL.
Group ID	string	Yes	—	The unique identifier of the target group in the board; find it by listing the board’s groups.
Return All	boolean	No	false	Whether to return all results or only up to a given limit.
Limit	number	No	50	Max number of results to return. (shown when Return All is false)

Board Item: Move

Parameter	Type	Required	Default	Description
Board ID	string	Yes	—	The board’s unique identifier, as shown in the board’s Monday.com URL.
Item ID	string	Yes	—	The item’s unique identifier; for get, several separated by commas.
Group ID	string	Yes	—	The unique identifier of the target group in the board; find it by listing the board’s groups.

All Operations

Parameter	Type	Required	Default	Description
Max Concurrency	number	No	10	Maximum number of items to process concurrently.

Output Data

The Monday.com response is merged into the item JSON at the top level: the incoming fields pass straight through and the response’s fields are written over them. Binary data on the input item is forwarded unchanged.

Reading operations fan out. Board: Get, Board: Get Many, Board Column: Get Many, Board Group: Get Many, Board Item: Get, Board Item: Get Many and Board Item: Get By Column Value return a list and emit one output item per record. When that list comes back empty, one output item is still emitted, carrying _noResults: true next to the passed-through input fields — check for it before treating the branch as real results. Every other operation emits exactly one output item per input item.

Resource: Operation	Fields merged onto the item
Board: Archive, Board: Create	id
Board: Get, Board: Get Many	id, name, description, state, board_folder_id, board_kind, owners
Board Column: Create	id
Board Column: Get Many	id, title, type, settings_str, archived
Board Group: Create, Board Group: Delete	id
Board Group: Get Many	id, title, color, position, archived
Board Item: Add Update, Change Column Value, Change Multiple Column Values, Create, Delete, Move	id
Board Item: Get, Board Item: Get Many	id, name, created_at, state, column_values
Board Item: Get By Column Value	id, name, created_at, state, board, column_values

Each entry in column_values carries id, text, type, value and a nested column with title, archived, description and settings_str.

Reference the result downstream by expression, e.g. {{ $json.id }}.

Example Configuration

Create a new board, cloned from a template:

{
  "type": "monday_com",
  "parameters": {
    "resource": "board",
    "operation": "create",
    "name": "Marketing Campaign Board",
    "kind": "public",
    "additionalFields": {
      "templateId": 123
    }
  }
}

Get boards, capped at 50:

{
  "type": "monday_com",
  "parameters": {
    "resource": "board",
    "operation": "getAll",
    "returnAll": false,
    "limit": 50
  }
}

Archive a board:

{
  "type": "monday_com",
  "parameters": {
    "resource": "board",
    "operation": "archive",
    "boardId": "123456789"
  }
}

Create a status column with its labels preset. Defaults is a JSON string, so the braces are escaped:

{
  "type": "monday_com",
  "parameters": {
    "resource": "boardColumn",
    "operation": "create",
    "boardId": "123456789",
    "title": "Project Status",
    "columnType": "status",
    "additionalFields": {
      "defaults": "{\"labels\":{\"0\":\"Not Started\",\"1\":\"In Progress\",\"2\":\"Complete\"}}"
    }
  }
}

List every column on a board — useful for discovering the column IDs the item operations need:

{
  "type": "monday_com",
  "parameters": {
    "resource": "boardColumn",
    "operation": "getAll",
    "boardId": "123456789"
  }
}

Create a group:

{
  "type": "monday_com",
  "parameters": {
    "resource": "boardGroup",
    "operation": "create",
    "boardId": "123456789",
    "name": "Q1 Tasks"
  }
}

Delete a group:

{
  "type": "monday_com",
  "parameters": {
    "resource": "boardGroup",
    "operation": "delete",
    "boardId": "123456789",
    "groupId": "group_12345"
  }
}

Create an item with its column values already filled in:

{
  "type": "monday_com",
  "parameters": {
    "resource": "boardItem",
    "operation": "create",
    "boardId": "123456789",
    "groupId": "group_12345",
    "name": "Design Homepage Mockup",
    "additionalFields": {
      "columnValues": "{\"status\":{\"label\":\"In Progress\"},\"date4\":{\"date\":\"2024-03-15\"}}"
    }
  }
}

Change a single column value:

{
  "type": "monday_com",
  "parameters": {
    "resource": "boardItem",
    "operation": "changeColumnValue",
    "boardId": "123456789",
    "itemId": "987654321",
    "columnId": "status",
    "value": "{\"label\":\"Complete\"}"
  }
}

Change several column values in one call:

{
  "type": "monday_com",
  "parameters": {
    "resource": "boardItem",
    "operation": "changeMultipleColumnValues",
    "boardId": "123456789",
    "itemId": "987654321",
    "columnValues": "{\"status\":{\"label\":\"Complete\"},\"date4\":{\"date\":\"2024-03-20\"},\"numbers\":100}"
  }
}

Find every item whose status column reads “In Progress”:

{
  "type": "monday_com",
  "parameters": {
    "resource": "boardItem",
    "operation": "getByColumnValue",
    "boardId": "123456789",
    "columnId": "status",
    "columnValue": "In Progress",
    "returnAll": true
  }
}

Post an update (comment) on an item:

{
  "type": "monday_com",
  "parameters": {
    "resource": "boardItem",
    "operation": "addUpdate",
    "itemId": "987654321",
    "value": "Completed the initial design review. Moving to development phase."
  }
}

Setting up a new project board takes four nodes in sequence. First create the board:

{
  "type": "monday_com",
  "parameters": {
    "resource": "board",
    "operation": "create",
    "name": "Website Redesign Project",
    "kind": "private"
  }
}

Then add the custom columns you need:

{
  "type": "monday_com",
  "parameters": {
    "resource": "boardColumn",
    "operation": "create",
    "boardId": "123456789",
    "title": "Priority",
    "columnType": "status"
  }
}

Then create the groups that will hold the work:

{
  "type": "monday_com",
  "parameters": {
    "resource": "boardGroup",
    "operation": "create",
    "boardId": "123456789",
    "name": "Design Phase"
  }
}

Finally add the tasks to a group:

{
  "type": "monday_com",
  "parameters": {
    "resource": "boardItem",
    "operation": "create",
    "boardId": "123456789",
    "groupId": "group_12345",
    "name": "Create wireframes"
  }
}

Read a page of items out of one group:

{
  "type": "monday_com",
  "parameters": {
    "resource": "boardItem",
    "operation": "getAll",
    "boardId": "123456789",
    "groupId": "group_12345",
    "returnAll": false,
    "limit": 100
  }
}

Error Handling

Mode	Behavior
stop	Halts workflow on first error
continue	Skips failed items, passes successful ones through
errorPort	Routes failed items to Error output port

Tips

This tool manages Monday.com boards, columns, groups, and items. It is ideal for creating, updating, or deleting work items, managing board structures, and searching items by column values. It produces changes within Monday.com, such as new boards, items, or updated column values, and retrieves information about these resources.

Parameter Dependencies

• limit only appears when returnAll is set to false
• additionalFields structure varies by operation type
• Column value formats must follow Monday.com API specifications for JSON fields
• Board IDs, group IDs, and column IDs must be obtained from previous API calls or the Monday.com interface