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 .
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/mondayEnvironment variables MONDAY_CLIENT_ID, MONDAY_CLIENT_SECRET
Scope Description boards:readRead boards, items, and columns boards:writeCreate and modify boards, items, and groups updates:readRead updates and comments updates:writeCreate and edit updates and comments webhooks:readRead webhook subscriptions webhooks:writeCreate and manage webhook subscriptions me:readRead your user profile
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.
List boards from your Monday.com account
Inputs and outputsParameter Type Required Description limitnumber No Maximum number of boards to return (default 25, max 500) pagenumber No Page number for pagination (starts at 1)
Parameter Type Description boardsarray 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 countnumber Number of boards returned
Get a specific Monday.com board with its groups and columns
Inputs and outputsParameter Type Required Description boardIdstring Yes The ID of the board to retrieve
Parameter Type Description boardjson 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 groupsarray 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 columnsarray Columns on the board ↳ id string Column ID ↳ title string Column title ↳ type string Column type
Get a specific item by ID from Monday.com
Inputs and outputsParameter Type Required Description itemIdstring Yes The ID of the item to retrieve
Parameter Type Description itemjson 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
Get items from a Monday.com board
Inputs and outputsParameter Type Required Description boardIdstring Yes The ID of the board to get items from groupIdstring No Filter items by group ID limitnumber No Maximum number of items to return (default 25, max 500)
Parameter Type Description itemsarray 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 countnumber Number of items returned
Search for items on a Monday.com board by column values
Inputs and outputsParameter Type Required Description boardIdstring Yes The ID of the board to search columnsstring Yes JSON array of column filters, e.g. [{"column_id":"status","column_values":["Done"]}] limitnumber No Maximum number of items to return (default 25, max 500) cursorstring No Pagination cursor from a previous search response
Parameter Type Description itemsarray 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 countnumber Number of items returned cursorstring Pagination cursor for fetching the next page
Create a new item on a Monday.com board
Inputs and outputsParameter Type Required Description boardIdstring Yes The ID of the board to create the item on itemNamestring Yes The name of the new item groupIdstring No The group ID to create the item in columnValuesstring No JSON string of column values to set (e.g., {"status":"Done","date":"2024-01-01"})
Parameter Type Description itemjson 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
Update column values of an item on a Monday.com board
Inputs and outputsParameter Type Required Description boardIdstring Yes The ID of the board containing the item itemIdstring Yes The ID of the item to update columnValuesstring Yes JSON string of column values to update (e.g., {"status":"Done","date":"2024-01-01"})
Parameter Type Description itemjson 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
Update a single column's value on a Monday.com item
Inputs and outputsParameter Type Required Description boardIdstring Yes The ID of the board containing the item itemIdstring Yes The ID of the item to update columnIdstring Yes The ID of the column to update (e.g., "status", "date4") valuestring Yes The new column value as a JSON string (e.g., {"label":"Done"} for a status column) createLabelsIfMissingboolean No Create status/dropdown labels that do not yet exist on the column
Parameter Type Description itemjson 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
Duplicate an existing item on a Monday.com board
Inputs and outputsParameter Type Required Description boardIdstring Yes The ID of the board containing the item itemIdstring Yes The ID of the item to duplicate withUpdatesboolean No Whether to also duplicate the item updates
Parameter Type Description itemjson 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
Delete an item from a Monday.com board
Inputs and outputsParameter Type Required Description itemIdstring Yes The ID of the item to delete
Parameter Type Description idstring The ID of the deleted item
Archive an item on a Monday.com board
Inputs and outputsParameter Type Required Description itemIdstring Yes The ID of the item to archive
Parameter Type Description idstring The ID of the archived item
Move an item to a different group on a Monday.com board
Inputs and outputsParameter Type Required Description itemIdstring Yes The ID of the item to move groupIdstring Yes The ID of the target group
Parameter Type Description itemjson 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
Create a subitem under a parent item on Monday.com
Inputs and outputsParameter Type Required Description parentItemIdstring Yes The ID of the parent item itemNamestring Yes The name of the new subitem columnValuesstring No JSON string of column values to set
Parameter Type Description itemjson 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
Add an update (comment) to a Monday.com item
Inputs and outputsParameter Type Required Description itemIdstring Yes The ID of the item to add the update to bodystring Yes The update text content (supports HTML)
Parameter Type Description updatejson 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
Create a new group on a Monday.com board
Inputs and outputsParameter Type Required Description boardIdstring Yes The ID of the board to create the group on groupNamestring Yes The name of the new group (max 255 characters) groupColorstring No The group color as a hex code (e.g., "#ff642e")
Parameter Type Description groupjson 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
Get the groups on a Monday.com board
Inputs and outputsParameter Type Required Description boardIdstring Yes The ID of the board to retrieve groups from
Parameter Type Description groupsarray 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 countnumber Number of returned groups
Create a new board in Monday.com
Inputs and outputsParameter Type Required Description boardNamestring Yes The name of the new board boardKindstring Yes The board kind: public, private, or share descriptionstring No The board description workspaceIdstring No The ID of the workspace to create the board in folderIdstring No The ID of the folder to create the board in
Parameter Type Description boardjson 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
Create a new column on a Monday.com board
Inputs and outputsParameter Type Required Description boardIdstring Yes The ID of the board to create the column on columnTitlestring Yes The title of the new column columnTypestring Yes The column type (e.g., status, text, numbers, date, people, dropdown) columnDescriptionstring No The column description columnDefaultsstring No JSON string of default settings for the column (e.g., status labels)
Parameter Type Description columnjson The created column ↳ id string Column ID ↳ title string Column title ↳ type string Column type
A trigger starts a workflow when a supported event occurs in this service.
Trigger workflow when any column value changes on a Monday.com board
Configuration and outputsParameter Type Required Description triggerCredentialsstring Yes Select your Monday.com account to create the webhook automatically. boardIdstring Yes The ID of the board to monitor. Find it in the URL: monday.com/boards/BOARD_ID
Parameter Type Description boardIdstring The board ID where the event occurred itemIdstring The item ID (pulseId) itemNamestring The item name (pulseName) groupIdstring The group ID of the item userIdstring The ID of the user who triggered the event triggerTimestring ISO timestamp of when the event occurred triggerUuidstring Unique identifier for this event subscriptionIdstring The webhook subscription ID columnIdstring The ID of the changed column columnTypestring The type of the changed column columnTitlestring The title of the changed column valuejson The new value of the column previousValuejson The previous value of the column
Trigger workflow when an item is archived on a Monday.com board
Configuration and outputsParameter Type Required Description triggerCredentialsstring Yes Select your Monday.com account to create the webhook automatically. boardIdstring Yes The ID of the board to monitor. Find it in the URL: monday.com/boards/BOARD_ID
Parameter Type Description boardIdstring The board ID where the event occurred itemIdstring The item ID (pulseId) itemNamestring The item name (pulseName) groupIdstring The group ID of the item userIdstring The ID of the user who triggered the event triggerTimestring ISO timestamp of when the event occurred triggerUuidstring Unique identifier for this event subscriptionIdstring The webhook subscription ID
Trigger workflow when a new item is created on a Monday.com board
Configuration and outputsParameter Type Required Description triggerCredentialsstring Yes Select your Monday.com account to create the webhook automatically. boardIdstring Yes The ID of the board to monitor. Find it in the URL: monday.com/boards/BOARD_ID
Parameter Type Description boardIdstring The board ID where the event occurred itemIdstring The item ID (pulseId) itemNamestring The item name (pulseName) groupIdstring The group ID of the item userIdstring The ID of the user who triggered the event triggerTimestring ISO timestamp of when the event occurred triggerUuidstring Unique identifier for this event subscriptionIdstring The webhook subscription ID
Trigger workflow when an item is deleted on a Monday.com board
Configuration and outputsParameter Type Required Description triggerCredentialsstring Yes Select your Monday.com account to create the webhook automatically. boardIdstring Yes The ID of the board to monitor. Find it in the URL: monday.com/boards/BOARD_ID
Parameter Type Description boardIdstring The board ID where the event occurred itemIdstring The item ID (pulseId) itemNamestring The item name (pulseName) groupIdstring The group ID of the item userIdstring The ID of the user who triggered the event triggerTimestring ISO timestamp of when the event occurred triggerUuidstring Unique identifier for this event subscriptionIdstring The webhook subscription ID
Trigger workflow when an item is moved to any group on a Monday.com board
Configuration and outputsParameter Type Required Description triggerCredentialsstring Yes Select your Monday.com account to create the webhook automatically. boardIdstring Yes The ID of the board to monitor. Find it in the URL: monday.com/boards/BOARD_ID
Parameter Type Description boardIdstring The board ID where the event occurred itemIdstring The item ID (pulseId) itemNamestring The item name (pulseName) groupIdstring The group ID of the item userIdstring The ID of the user who triggered the event triggerTimestring ISO timestamp of when the event occurred triggerUuidstring Unique identifier for this event subscriptionIdstring The webhook subscription ID destGroupIdstring The destination group ID the item was moved to sourceGroupIdstring The source group ID the item was moved from
Trigger workflow when an item name changes on a Monday.com board
Configuration and outputsParameter Type Required Description triggerCredentialsstring Yes Select your Monday.com account to create the webhook automatically. boardIdstring Yes The ID of the board to monitor. Find it in the URL: monday.com/boards/BOARD_ID
Parameter Type Description boardIdstring The board ID where the event occurred itemIdstring The item ID (pulseId) itemNamestring The item name (pulseName) groupIdstring The group ID of the item userIdstring The ID of the user who triggered the event triggerTimestring ISO timestamp of when the event occurred triggerUuidstring Unique identifier for this event subscriptionIdstring The webhook subscription ID columnIdstring The ID of the changed column columnTypestring The type of the changed column columnTitlestring The title of the changed column valuejson The new value of the column previousValuejson The previous value of the column
Trigger workflow when a status column value changes on a Monday.com board
Configuration and outputsParameter Type Required Description triggerCredentialsstring Yes Select your Monday.com account to create the webhook automatically. boardIdstring Yes The ID of the board to monitor. Find it in the URL: monday.com/boards/BOARD_ID
Parameter Type Description boardIdstring The board ID where the event occurred itemIdstring The item ID (pulseId) itemNamestring The item name (pulseName) groupIdstring The group ID of the item userIdstring The ID of the user who triggered the event triggerTimestring ISO timestamp of when the event occurred triggerUuidstring Unique identifier for this event subscriptionIdstring The webhook subscription ID columnIdstring The ID of the changed column columnTypestring The type of the changed column columnTitlestring The title of the changed column valuejson The new value of the column previousValuejson The previous value of the column
Trigger workflow when a subitem is created on a Monday.com board
Configuration and outputsParameter Type Required Description triggerCredentialsstring Yes Select your Monday.com account to create the webhook automatically. boardIdstring Yes The ID of the board to monitor. Find it in the URL: monday.com/boards/BOARD_ID
Parameter Type Description boardIdstring The board ID where the event occurred itemIdstring The item ID (pulseId) itemNamestring The item name (pulseName) groupIdstring The group ID of the item userIdstring The ID of the user who triggered the event triggerTimestring ISO timestamp of when the event occurred triggerUuidstring Unique identifier for this event subscriptionIdstring The webhook subscription ID parentItemIdstring The parent item ID parentItemBoardIdstring The parent item board ID
Trigger workflow when an update or comment is posted on a Monday.com item
Configuration and outputsParameter Type Required Description triggerCredentialsstring Yes Select your Monday.com account to create the webhook automatically. boardIdstring Yes The ID of the board to monitor. Find it in the URL: monday.com/boards/BOARD_ID
Parameter Type Description boardIdstring The board ID where the event occurred itemIdstring The item ID (pulseId) itemNamestring The item name (pulseName) groupIdstring The group ID of the item userIdstring The ID of the user who triggered the event triggerTimestring ISO timestamp of when the event occurred triggerUuidstring Unique identifier for this event subscriptionIdstring The webhook subscription ID updateIdstring The ID of the created update bodystring The HTML body of the update textBodystring The plain text body of the update