Monday

Use Monday.com to manage boards, groups, columns, items, and subitems. Read or search items by column values, create or update them, duplicate or move them between groups, and archive or delete them. Updates let a workflow post comments.

Webhook triggers start workflows when items are created, deleted, or moved; column or status values change; or updates are posted. Use these events to synchronize board activity with another system.

Connection guides: API tokens.

OAuth scopes

Sim requests these scopes when someone connects a Monday.com account. For a self-hosted deployment, register your own app with the provider using the settings below. See Integrations and OAuth for setup.

Setting	Value
Redirect URI	`<NEXT_PUBLIC_APP_URL>/api/auth/oauth2/callback/monday`
Environment variables	`MONDAY_CLIENT_ID`, `MONDAY_CLIENT_SECRET`

Scope	Description
`boards:read`	Read boards, items, and columns
`boards:write`	Create and modify boards, items, and groups
`updates:read`	Read updates and comments
`updates:write`	Create and edit updates and comments
`webhooks:read`	Read webhook subscriptions
`webhooks:write`	Create and manage webhook subscriptions
`me:read`	Read your user profile

Use the block

Read or manage boards, groups, columns, items, and subitems in Monday.com. Search items, change column values, move or archive items, post updates, and start workflows from supported board events.

Actions

Monday List Boards

List boards from your Monday.com account

Inputs and outputs

Input

Parameter	Type	Required	Description
`limit`	number	No	Maximum number of boards to return (default 25, max 500)
`page`	number	No	Page number for pagination (starts at 1)

Output

Parameter	Type	Description
`boards`	array	List of Monday.com boards
↳ `id`	string	Board ID
↳ `name`	string	Board name
↳ `description`	string	Board description
↳ `state`	string	Board state (active, archived, deleted)
↳ `boardKind`	string	Board kind (public, private, share)
↳ `itemsCount`	number	Number of items on the board
↳ `url`	string	Board URL
↳ `updatedAt`	string	Last updated timestamp
`count`	number	Number of boards returned

Monday Get Board

Get a specific Monday.com board with its groups and columns

Inputs and outputs

Input

Parameter	Type	Required	Description
`boardId`	string	Yes	The ID of the board to retrieve

Output

Parameter	Type	Description
`board`	json	Board details
↳ `id`	string	Board ID
↳ `name`	string	Board name
↳ `description`	string	Board description
↳ `state`	string	Board state
↳ `boardKind`	string	Board kind (public, private, share)
↳ `itemsCount`	number	Number of items
↳ `url`	string	Board URL
↳ `updatedAt`	string	Last updated timestamp
`groups`	array	Groups on the board
↳ `id`	string	Group ID
↳ `title`	string	Group title
↳ `color`	string	Group color (hex)
↳ `archived`	boolean	Whether the group is archived
↳ `deleted`	boolean	Whether the group is deleted
↳ `position`	string	Group position
`columns`	array	Columns on the board
↳ `id`	string	Column ID
↳ `title`	string	Column title
↳ `type`	string	Column type

Monday Get Item

Get a specific item by ID from Monday.com

Inputs and outputs

Input

Parameter	Type	Required	Description
`itemId`	string	Yes	The ID of the item to retrieve

Output

Parameter	Type	Description
`item`	json	The requested item
↳ `id`	string	Item ID
↳ `name`	string	Item name
↳ `state`	string	Item state
↳ `boardId`	string	Board ID
↳ `groupId`	string	Group ID
↳ `groupTitle`	string	Group title
↳ `columnValues`	array	Column values
↳ `id`	string	Column ID
↳ `text`	string	Text value
↳ `value`	string	Raw JSON value
↳ `type`	string	Column type
↳ `createdAt`	string	Creation timestamp
↳ `updatedAt`	string	Last updated timestamp
↳ `url`	string	Item URL

Monday Get Items

Get items from a Monday.com board

Inputs and outputs

Input

Parameter	Type	Required	Description
`boardId`	string	Yes	The ID of the board to get items from
`groupId`	string	No	Filter items by group ID
`limit`	number	No	Maximum number of items to return (default 25, max 500)

Output

Parameter	Type	Description
`items`	array	List of items from the board
↳ `id`	string	Item ID
↳ `name`	string	Item name
↳ `state`	string	Item state (active, archived, deleted)
↳ `boardId`	string	Board ID
↳ `groupId`	string	Group ID
↳ `groupTitle`	string	Group title
↳ `columnValues`	array	Column values for the item
↳ `id`	string	Column ID
↳ `text`	string	Human-readable text value
↳ `value`	string	Raw JSON value
↳ `type`	string	Column type
↳ `createdAt`	string	Creation timestamp
↳ `updatedAt`	string	Last updated timestamp
↳ `url`	string	Item URL
`count`	number	Number of items returned

Monday Search Items

Search for items on a Monday.com board by column values

Inputs and outputs

Input

Parameter	Type	Required	Description
`boardId`	string	Yes	The ID of the board to search
`columns`	string	Yes	JSON array of column filters, e.g. [{"column_id":"status","column_values":["Done"]}]
`limit`	number	No	Maximum number of items to return (default 25, max 500)
`cursor`	string	No	Pagination cursor from a previous search response

Output

Parameter	Type	Description
`items`	array	Matching items
↳ `id`	string	Item ID
↳ `name`	string	Item name
↳ `state`	string	Item state
↳ `boardId`	string	Board ID
↳ `groupId`	string	Group ID
↳ `groupTitle`	string	Group title
↳ `columnValues`	array	Column values
↳ `id`	string	Column ID
↳ `text`	string	Text value
↳ `value`	string	Raw JSON value
↳ `type`	string	Column type
↳ `createdAt`	string	Creation timestamp
↳ `updatedAt`	string	Last updated timestamp
↳ `url`	string	Item URL
`count`	number	Number of items returned
`cursor`	string	Pagination cursor for fetching the next page

Monday Create Item

Create a new item on a Monday.com board

Inputs and outputs

Input

Parameter	Type	Required	Description
`boardId`	string	Yes	The ID of the board to create the item on
`itemName`	string	Yes	The name of the new item
`groupId`	string	No	The group ID to create the item in
`columnValues`	string	No	JSON string of column values to set (e.g., {"status":"Done","date":"2024-01-01"})

Output

Parameter	Type	Description
`item`	json	The created item
↳ `id`	string	Item ID
↳ `name`	string	Item name
↳ `state`	string	Item state
↳ `boardId`	string	Board ID
↳ `groupId`	string	Group ID
↳ `groupTitle`	string	Group title
↳ `columnValues`	array	Column values
↳ `id`	string	Column ID
↳ `text`	string	Text value
↳ `value`	string	Raw JSON value
↳ `type`	string	Column type
↳ `createdAt`	string	Creation timestamp
↳ `updatedAt`	string	Last updated timestamp
↳ `url`	string	Item URL

Monday Update Item

Update column values of an item on a Monday.com board

Inputs and outputs

Input

Parameter	Type	Required	Description
`boardId`	string	Yes	The ID of the board containing the item
`itemId`	string	Yes	The ID of the item to update
`columnValues`	string	Yes	JSON string of column values to update (e.g., {"status":"Done","date":"2024-01-01"})

Output

Parameter	Type	Description
`item`	json	The updated item
↳ `id`	string	Item ID
↳ `name`	string	Item name
↳ `state`	string	Item state
↳ `boardId`	string	Board ID
↳ `groupId`	string	Group ID
↳ `groupTitle`	string	Group title
↳ `columnValues`	array	Column values
↳ `id`	string	Column ID
↳ `text`	string	Text value
↳ `value`	string	Raw JSON value
↳ `type`	string	Column type
↳ `createdAt`	string	Creation timestamp
↳ `updatedAt`	string	Last updated timestamp
↳ `url`	string	Item URL

Monday Change Column Value

Update a single column's value on a Monday.com item

Inputs and outputs

Input

Parameter	Type	Required	Description
`boardId`	string	Yes	The ID of the board containing the item
`itemId`	string	Yes	The ID of the item to update
`columnId`	string	Yes	The ID of the column to update (e.g., "status", "date4")
`value`	string	Yes	The new column value as a JSON string (e.g., {"label":"Done"} for a status column)
`createLabelsIfMissing`	boolean	No	Create status/dropdown labels that do not yet exist on the column

Output

Parameter	Type	Description
`item`	json	The updated item
↳ `id`	string	Item ID
↳ `name`	string	Item name
↳ `state`	string	Item state
↳ `boardId`	string	Board ID
↳ `groupId`	string	Group ID
↳ `groupTitle`	string	Group title
↳ `columnValues`	array	Column values
↳ `id`	string	Column ID
↳ `text`	string	Text value
↳ `value`	string	Raw JSON value
↳ `type`	string	Column type
↳ `createdAt`	string	Creation timestamp
↳ `updatedAt`	string	Last updated timestamp
↳ `url`	string	Item URL

Monday Duplicate Item

Duplicate an existing item on a Monday.com board

Inputs and outputs

Input

Parameter	Type	Required	Description
`boardId`	string	Yes	The ID of the board containing the item
`itemId`	string	Yes	The ID of the item to duplicate
`withUpdates`	boolean	No	Whether to also duplicate the item updates

Output

Parameter	Type	Description
`item`	json	The duplicated item
↳ `id`	string	Item ID
↳ `name`	string	Item name
↳ `state`	string	Item state
↳ `boardId`	string	Board ID
↳ `groupId`	string	Group ID
↳ `groupTitle`	string	Group title
↳ `columnValues`	array	Column values
↳ `id`	string	Column ID
↳ `text`	string	Text value
↳ `value`	string	Raw JSON value
↳ `type`	string	Column type
↳ `createdAt`	string	Creation timestamp
↳ `updatedAt`	string	Last updated timestamp
↳ `url`	string	Item URL

Monday Delete Item

Delete an item from a Monday.com board

Inputs and outputs

Input

Parameter	Type	Required	Description
`itemId`	string	Yes	The ID of the item to delete

Output

Parameter	Type	Description
`id`	string	The ID of the deleted item

Monday Archive Item

Archive an item on a Monday.com board

Inputs and outputs

Input

Parameter	Type	Required	Description
`itemId`	string	Yes	The ID of the item to archive

Output

Parameter	Type	Description
`id`	string	The ID of the archived item

Monday Move Item to Group

Move an item to a different group on a Monday.com board

Inputs and outputs

Input

Parameter	Type	Required	Description
`itemId`	string	Yes	The ID of the item to move
`groupId`	string	Yes	The ID of the target group

Output

Parameter	Type	Description
`item`	json	The moved item with updated group
↳ `id`	string	Item ID
↳ `name`	string	Item name
↳ `state`	string	Item state
↳ `boardId`	string	Board ID
↳ `groupId`	string	Group ID
↳ `groupTitle`	string	Group title
↳ `columnValues`	array	Column values
↳ `id`	string	Column ID
↳ `text`	string	Text value
↳ `value`	string	Raw JSON value
↳ `type`	string	Column type
↳ `createdAt`	string	Creation timestamp
↳ `updatedAt`	string	Last updated timestamp
↳ `url`	string	Item URL

Monday Create Subitem

Create a subitem under a parent item on Monday.com

Inputs and outputs

Input

Parameter	Type	Required	Description
`parentItemId`	string	Yes	The ID of the parent item
`itemName`	string	Yes	The name of the new subitem
`columnValues`	string	No	JSON string of column values to set

Output

Parameter	Type	Description
`item`	json	The created subitem
↳ `id`	string	Item ID
↳ `name`	string	Item name
↳ `state`	string	Item state
↳ `boardId`	string	Board ID
↳ `groupId`	string	Group ID
↳ `groupTitle`	string	Group title
↳ `columnValues`	array	Column values
↳ `id`	string	Column ID
↳ `text`	string	Text value
↳ `value`	string	Raw JSON value
↳ `type`	string	Column type
↳ `createdAt`	string	Creation timestamp
↳ `updatedAt`	string	Last updated timestamp
↳ `url`	string	Item URL

Monday Create Update

Add an update (comment) to a Monday.com item

Inputs and outputs

Input

Parameter	Type	Required	Description
`itemId`	string	Yes	The ID of the item to add the update to
`body`	string	Yes	The update text content (supports HTML)

Output

Parameter	Type	Description
`update`	json	The created update
↳ `id`	string	Update ID
↳ `body`	string	Update body (HTML)
↳ `textBody`	string	Plain text body
↳ `createdAt`	string	Creation timestamp
↳ `creatorId`	string	Creator user ID
↳ `itemId`	string	Item ID

Monday Create Group

Create a new group on a Monday.com board

Inputs and outputs

Input

Parameter	Type	Required	Description
`boardId`	string	Yes	The ID of the board to create the group on
`groupName`	string	Yes	The name of the new group (max 255 characters)
`groupColor`	string	No	The group color as a hex code (e.g., "#ff642e")

Output

Parameter	Type	Description
`group`	json	The created group
↳ `id`	string	Group ID
↳ `title`	string	Group title
↳ `color`	string	Group color (hex)
↳ `archived`	boolean	Whether archived
↳ `deleted`	boolean	Whether deleted
↳ `position`	string	Group position

Monday Get Groups

Get the groups on a Monday.com board

Inputs and outputs

Input

Parameter	Type	Required	Description
`boardId`	string	Yes	The ID of the board to retrieve groups from

Output

Parameter	Type	Description
`groups`	array	Groups on the board
↳ `id`	string	Group ID
↳ `title`	string	Group title
↳ `color`	string	Group color (hex)
↳ `archived`	boolean	Whether the group is archived
↳ `deleted`	boolean	Whether the group is deleted
↳ `position`	string	Group position
`count`	number	Number of returned groups

Monday Create Board

Create a new board in Monday.com

Inputs and outputs

Input

Parameter	Type	Required	Description
`boardName`	string	Yes	The name of the new board
`boardKind`	string	Yes	The board kind: public, private, or share
`description`	string	No	The board description
`workspaceId`	string	No	The ID of the workspace to create the board in
`folderId`	string	No	The ID of the folder to create the board in

Output

Parameter	Type	Description
`board`	json	The created board
↳ `id`	string	Board ID
↳ `name`	string	Board name
↳ `description`	string	Board description
↳ `state`	string	Board state
↳ `boardKind`	string	Board kind (public, private, share)
↳ `itemsCount`	number	Number of items
↳ `url`	string	Board URL
↳ `updatedAt`	string	Last updated timestamp

Monday Create Column

Create a new column on a Monday.com board

Inputs and outputs

Input

Parameter	Type	Required	Description
`boardId`	string	Yes	The ID of the board to create the column on
`columnTitle`	string	Yes	The title of the new column
`columnType`	string	Yes	The column type (e.g., status, text, numbers, date, people, dropdown)
`columnDescription`	string	No	The column description
`columnDefaults`	string	No	JSON string of default settings for the column (e.g., status labels)

Output

Parameter	Type	Description
`column`	json	The created column
↳ `id`	string	Column ID
↳ `title`	string	Column title
↳ `type`	string	Column type

Triggers

A trigger starts a workflow when a supported event occurs in this service.

Monday Column Value Changed

Trigger workflow when any column value changes on a Monday.com board

Configuration and outputs

Configuration

Parameter	Type	Required	Description
`triggerCredentials`	string	Yes	Select your Monday.com account to create the webhook automatically.
`boardId`	string	Yes	The ID of the board to monitor. Find it in the URL: monday.com/boards/BOARD_ID

Output

Parameter	Type	Description
`boardId`	string	The board ID where the event occurred
`itemId`	string	The item ID (pulseId)
`itemName`	string	The item name (pulseName)
`groupId`	string	The group ID of the item
`userId`	string	The ID of the user who triggered the event
`triggerTime`	string	ISO timestamp of when the event occurred
`triggerUuid`	string	Unique identifier for this event
`subscriptionId`	string	The webhook subscription ID
`columnId`	string	The ID of the changed column
`columnType`	string	The type of the changed column
`columnTitle`	string	The title of the changed column
`value`	json	The new value of the column
`previousValue`	json	The previous value of the column

Monday Item Archived

Trigger workflow when an item is archived on a Monday.com board

Configuration and outputs

Configuration

Parameter	Type	Required	Description
`triggerCredentials`	string	Yes	Select your Monday.com account to create the webhook automatically.
`boardId`	string	Yes	The ID of the board to monitor. Find it in the URL: monday.com/boards/BOARD_ID

Output

Parameter	Type	Description
`boardId`	string	The board ID where the event occurred
`itemId`	string	The item ID (pulseId)
`itemName`	string	The item name (pulseName)
`groupId`	string	The group ID of the item
`userId`	string	The ID of the user who triggered the event
`triggerTime`	string	ISO timestamp of when the event occurred
`triggerUuid`	string	Unique identifier for this event
`subscriptionId`	string	The webhook subscription ID

Monday Item Created

Trigger workflow when a new item is created on a Monday.com board

Configuration and outputs

Configuration

Parameter	Type	Required	Description
`triggerCredentials`	string	Yes	Select your Monday.com account to create the webhook automatically.
`boardId`	string	Yes	The ID of the board to monitor. Find it in the URL: monday.com/boards/BOARD_ID

Output

Parameter	Type	Description
`boardId`	string	The board ID where the event occurred
`itemId`	string	The item ID (pulseId)
`itemName`	string	The item name (pulseName)
`groupId`	string	The group ID of the item
`userId`	string	The ID of the user who triggered the event
`triggerTime`	string	ISO timestamp of when the event occurred
`triggerUuid`	string	Unique identifier for this event
`subscriptionId`	string	The webhook subscription ID

Monday Item Deleted

Trigger workflow when an item is deleted on a Monday.com board

Configuration and outputs

Configuration

Parameter	Type	Required	Description
`triggerCredentials`	string	Yes	Select your Monday.com account to create the webhook automatically.
`boardId`	string	Yes	The ID of the board to monitor. Find it in the URL: monday.com/boards/BOARD_ID

Output

Parameter	Type	Description
`boardId`	string	The board ID where the event occurred
`itemId`	string	The item ID (pulseId)
`itemName`	string	The item name (pulseName)
`groupId`	string	The group ID of the item
`userId`	string	The ID of the user who triggered the event
`triggerTime`	string	ISO timestamp of when the event occurred
`triggerUuid`	string	Unique identifier for this event
`subscriptionId`	string	The webhook subscription ID

Monday Item Moved to Group

Trigger workflow when an item is moved to any group on a Monday.com board

Configuration and outputs

Configuration

Parameter	Type	Required	Description
`triggerCredentials`	string	Yes	Select your Monday.com account to create the webhook automatically.
`boardId`	string	Yes	The ID of the board to monitor. Find it in the URL: monday.com/boards/BOARD_ID

Output

Parameter	Type	Description
`boardId`	string	The board ID where the event occurred
`itemId`	string	The item ID (pulseId)
`itemName`	string	The item name (pulseName)
`groupId`	string	The group ID of the item
`userId`	string	The ID of the user who triggered the event
`triggerTime`	string	ISO timestamp of when the event occurred
`triggerUuid`	string	Unique identifier for this event
`subscriptionId`	string	The webhook subscription ID
`destGroupId`	string	The destination group ID the item was moved to
`sourceGroupId`	string	The source group ID the item was moved from

Monday Item Name Changed

Trigger workflow when an item name changes on a Monday.com board

Configuration and outputs

Configuration

Parameter	Type	Required	Description
`triggerCredentials`	string	Yes	Select your Monday.com account to create the webhook automatically.
`boardId`	string	Yes	The ID of the board to monitor. Find it in the URL: monday.com/boards/BOARD_ID

Output

Parameter	Type	Description
`boardId`	string	The board ID where the event occurred
`itemId`	string	The item ID (pulseId)
`itemName`	string	The item name (pulseName)
`groupId`	string	The group ID of the item
`userId`	string	The ID of the user who triggered the event
`triggerTime`	string	ISO timestamp of when the event occurred
`triggerUuid`	string	Unique identifier for this event
`subscriptionId`	string	The webhook subscription ID
`columnId`	string	The ID of the changed column
`columnType`	string	The type of the changed column
`columnTitle`	string	The title of the changed column
`value`	json	The new value of the column
`previousValue`	json	The previous value of the column

Monday Status Changed

Trigger workflow when a status column value changes on a Monday.com board

Configuration and outputs

Configuration

Parameter	Type	Required	Description
`triggerCredentials`	string	Yes	Select your Monday.com account to create the webhook automatically.
`boardId`	string	Yes	The ID of the board to monitor. Find it in the URL: monday.com/boards/BOARD_ID

Output

Parameter	Type	Description
`boardId`	string	The board ID where the event occurred
`itemId`	string	The item ID (pulseId)
`itemName`	string	The item name (pulseName)
`groupId`	string	The group ID of the item
`userId`	string	The ID of the user who triggered the event
`triggerTime`	string	ISO timestamp of when the event occurred
`triggerUuid`	string	Unique identifier for this event
`subscriptionId`	string	The webhook subscription ID
`columnId`	string	The ID of the changed column
`columnType`	string	The type of the changed column
`columnTitle`	string	The title of the changed column
`value`	json	The new value of the column
`previousValue`	json	The previous value of the column

Monday Subitem Created

Trigger workflow when a subitem is created on a Monday.com board

Configuration and outputs

Configuration

Parameter	Type	Required	Description
`triggerCredentials`	string	Yes	Select your Monday.com account to create the webhook automatically.
`boardId`	string	Yes	The ID of the board to monitor. Find it in the URL: monday.com/boards/BOARD_ID

Output

Parameter	Type	Description
`boardId`	string	The board ID where the event occurred
`itemId`	string	The item ID (pulseId)
`itemName`	string	The item name (pulseName)
`groupId`	string	The group ID of the item
`userId`	string	The ID of the user who triggered the event
`triggerTime`	string	ISO timestamp of when the event occurred
`triggerUuid`	string	Unique identifier for this event
`subscriptionId`	string	The webhook subscription ID
`parentItemId`	string	The parent item ID
`parentItemBoardId`	string	The parent item board ID

Monday Update Posted

Trigger workflow when an update or comment is posted on a Monday.com item

Configuration and outputs

Configuration

Parameter	Type	Required	Description
`triggerCredentials`	string	Yes	Select your Monday.com account to create the webhook automatically.
`boardId`	string	Yes	The ID of the board to monitor. Find it in the URL: monday.com/boards/BOARD_ID

Output

Parameter	Type	Description
`boardId`	string	The board ID where the event occurred
`itemId`	string	The item ID (pulseId)
`itemName`	string	The item name (pulseName)
`groupId`	string	The group ID of the item
`userId`	string	The ID of the user who triggered the event
`triggerTime`	string	ISO timestamp of when the event occurred
`triggerUuid`	string	Unique identifier for this event
`subscriptionId`	string	The webhook subscription ID
`updateId`	string	The ID of the created update
`body`	string	The HTML body of the update
`textBody`	string	The plain text body of the update