<!-- BusyBot node reference — https://busybot.net/tools/monday-com/ -->

> Node: Monday.com (`monday_com`) · Action · v1
> Category: Productivity · Credentials: Monday.com (`mondayComApi`)
> Updated: 2026-08-16

# Monday.com

> Manage boards, columns, groups, and items in Monday.com.

## 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.

**Category:** Productivity  
**Tool Name:** `monday_com`  
**Version:** 1

**Appearance:** Icon: `lucide-LayoutList` | Color: `#FF3D57`

## 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](https://busybot.net/credentials/monday-com-api/) 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 (`boardId`) | `string` | Yes | — | The unique identifier of the board. Find in Monday.com: click board > look at URL for the board ID number. Supports expressions. |

#### Board: Create

| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| Name (`name`) | `string` | Yes | — | The board's name. Supports expressions. |
| Kind | `options` | Yes | — | The board's kind (public / private / share). |
| | | | | Options: `share`, `public`, `private` |
| Additional Fields (`additionalFields`) | `collection` | No | `{}` | Optional extra settings applied when the board is created. |
| — Template ID | `number` | No | `0` | Optional board template ID to clone from. |

#### Board: Get

| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| Board ID (`boardId`) | `string` | Yes | — | The unique identifier of the board. Supports expressions. |

#### Board: Get Many

| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| Return All (`returnAll`) | `boolean` | No | `false` | Whether to return all results or only up to a given limit. |
| Limit (`limit`) | `number` | No | `50` | Max number of results to return. Accepts 1–100. _(shown when Return All is `false`)_ |

#### Board Column: Create

| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| Board ID (`boardId`) | `string` | Yes | — | The unique identifier of the board to add a column to. Supports expressions. |
| Title | `string` | Yes | — | The title for the new column. Supports expressions. |
| 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 (`additionalFields`) | `collection` | No | `{}` | Optional extra settings applied when the column is created. |
| — Defaults | `json` | No | — | The new column's defaults as a JSON string. |

#### Board Column: Get Many

| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| Board ID (`boardId`) | `string` | Yes | — | The unique identifier of the board to get columns from. Supports expressions. |

#### Board Group: Create

| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| Board ID (`boardId`) | `string` | Yes | — | The unique identifier of the board to add a group to. Supports expressions. |
| Name (`name`) | `string` | Yes | — | The name of the group to create. Supports expressions. |

#### Board Group: Delete

| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| Board ID (`boardId`) | `string` | Yes | — | The unique identifier of the board containing the group. Supports expressions. |
| Group ID (`groupId`) | `string` | Yes | — | The unique identifier of the group to delete. Find by listing groups for the board. Supports expressions. |

#### Board Group: Get Many

| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| Board ID (`boardId`) | `string` | Yes | — | The unique identifier of the board to get groups from. Supports expressions. |

#### Board Item: Add Update

| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| Item ID (`itemId`) | `string` | Yes | — | The unique identifier of the item to add an update to. Supports expressions. |
| Update Text | `string` | Yes | — | The update text to add to the item. Supports expressions. |

#### Board Item: Change Column Value

| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| Board ID (`boardId`) | `string` | Yes | — | The unique identifier of the board. Supports expressions. |
| Item ID (`itemId`) | `string` | Yes | — | The unique identifier of the item to change column of. Supports expressions. |
| Column ID (`columnId`) | `string` | Yes | — | The column's unique identifier. Find by listing columns for the board. Supports expressions. |
| Value | `json` | Yes | — | The column value in JSON format. 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 (`boardId`) | `string` | Yes | — | The unique identifier of the board. Supports expressions. |
| Item ID (`itemId`) | `string` | Yes | — | The item's unique identifier. Supports expressions. |
| 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 (`boardId`) | `string` | Yes | — | The unique identifier of the board to create the item in. Supports expressions. |
| Group ID (`groupId`) | `string` | Yes | — | The unique identifier of the group to create the item in. Find by listing groups for the board. Supports expressions. |
| Name (`name`) | `string` | Yes | — | The new item's name. Supports expressions. |
| Additional Fields (`additionalFields`) | `collection` | No | `{}` | Optional extra settings applied when the item is created. |
| — 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 (`itemId`) | `string` | Yes | — | The item's unique identifier. Supports expressions. |

#### Board Item: Get

| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| Item ID (`itemId`) | `string` | Yes | — | Item's ID. Multiple can be added separated by comma. Supports expressions. |

#### Board Item: Get Many

| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| Board ID (`boardId`) | `string` | Yes | — | The unique identifier of the board. Supports expressions. |
| Group ID (`groupId`) | `string` | Yes | — | The unique identifier of the group. Find by listing groups for the board. Supports expressions. |
| Return All (`returnAll`) | `boolean` | No | `false` | Whether to return all results or only up to a given limit. |
| Limit (`limit`) | `number` | No | `50` | Max number of results to return. Accepts 1–100. _(shown when Return All is `false`)_ |

#### Board Item: Get By Column Value

| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| Board ID (`boardId`) | `string` | Yes | — | The unique identifier of the board. Supports expressions. |
| Column ID (`columnId`) | `string` | Yes | — | The column's unique identifier to search by. Find by listing columns for the board. Supports expressions. |
| Column Value | `string` | Yes | — | The column value to search items by. Supports expressions. |
| Return All (`returnAll`) | `boolean` | No | `false` | Whether to return all results or only up to a given limit. |
| Limit (`limit`) | `number` | No | `50` | Max number of results to return. Accepts 1–100. _(shown when Return All is `false`)_ |

#### Board Item: Move

| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| Board ID (`boardId`) | `string` | Yes | — | The unique identifier of the board (used to look up groups). Supports expressions. |
| Item ID (`itemId`) | `string` | Yes | — | The item's unique identifier. Supports expressions. |
| Group ID (`groupId`) | `string` | Yes | — | The unique identifier of the target group to move the item to. Supports expressions. |

#### All Operations

| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| Max Concurrency | `number` | No | `10` | Maximum number of items to process concurrently. Accepts 1–100. |

## 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 }}`.

## Usage Examples

- Create a new board in Monday.com
- Get all items from a Monday.com board group
- Create a new item in a Monday.com board
- Change column values for a Monday.com item
- Search Monday.com items by column value
- Move a Monday.com item to a different group
- Archive a Monday.com board
- Add an update (comment) to a Monday.com item

## Example Configuration

Create a new board, cloned from a template:

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

Get boards, capped at 50:

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

Archive a board:

```json
{
  "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:

```json
{
  "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:

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

Create a group:

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

Delete a group:

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

Create an item with its column values already filled in:

```json
{
  "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:

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

Change several column values in one call:

```json
{
  "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":

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

Post an update (comment) on an item:

```json
{
  "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:

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

Then add the custom columns you need:

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

Then create the groups that will hold the work:

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

Finally add the tasks to a group:

```json
{
  "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:

```json
{
  "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

Manages Monday.com boards, columns, groups, and items via GraphQL API -- create, read, update, and delete work items, manage board structure, and search items by column values.

### 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