Monday.com

Overview

monday.com is a customizable work management platform for project planning, collaboration, and automation, supporting agile, sales, marketing, and more. With the integration in SquadOS, your agents can create and manage boards, items, and groups, move tasks across workflows, post updates, and notify team members — all programmatically.

• Official website: https://monday.com/
• Composio documentation: docs.composio.dev/toolkits/monday

Authentication

This tool uses OAuth 2.0 (OAUTH2) to connect.

You will need to authorize access to your Monday.com account via OAuth. No manual API key is required — the authorization flow is managed by Composio.

Note

Monday.com requires a workspace admin to install the OAuth2 app before any user in that workspace can authorize their account. If the app is not installed, users will see an authorization error when trying to connect.

How to get credentials

1. A workspace admin must visit the following URL to install the Composio OAuth2 app once: https://auth.monday.com/oauth2/authorize?client_id=96b038435fc029e045f9ba800e66fefa&response_type=install
2. After the admin installs the app, any user in the workspace can authorize their Monday.com account through Composio’s standard OAuth flow.
3. To set up custom OAuth credentials (your own app), see the guide at composio.dev/auth/monday.

Tip

The admin only needs to install the app once per workspace. After that, any user in the workspace can connect their own account individually.

How to connect in SquadOS

1. Go to Tools in the side menu (/admin/tools).
2. Open the Available tab and search for Monday.com.
3. Click the card to open the details modal and hit Connect.
4. You’re taken to the secure connection page hosted by Composio, where you authorize access to your Monday.com account via OAuth.
5. Once done, you’re sent back to SquadOS with the account connected and the tool available to your agents. (Connection-flow details in Organization Tools.)

FAQ

Why is Monday.com OAuth2 not working for my users?

Monday.com requires a workspace admin to install the OAuth2 app before any user in that workspace can authorize their account. If the app is not installed, users will see an authorization error when trying to connect.

Do I need to install the app for each user?

No. The admin only needs to install the app once per workspace. After that, any user in the workspace can connect their Monday.com account through Composio’s OAuth2 flow.

How do I configure scopes for Monday.com?

Monday.com doesn’t accept scopes in the auth config the way Google does. Scopes are configured on the OAuth app itself. If you’re using the default OAuth app, the required scopes are already configured. For custom apps, add the scopes you need such as boards:read, boards:write, updates:write, and others.

Available actions

Note

This integration exposes 125 actions in total. The most relevant ones are listed below; see the full list in the Composio documentation.

Get boards

MONDAY_BOARDS

Tool to retrieve board data via the Monday.com API. Returns core metadata (id, name, state, kind, hierarchy type, workspace) about one or multiple boards with filtering options by state, board kind, hierarchy type, and workspace.

Input parameters

Name	Type	Required	Description
ids	array	No	List of specific board IDs to retrieve.
page	integer	No	Page number for pagination; starts at 1.
limit	integer	No	Maximum number of boards to return. Default is 25.
state	string	No	Filter boards by state. Valid values: active, archived, deleted, all. Default is active.
order_by	string	No	Sort boards by created_at or used_at in descending order.
board_kind	string	No	Filter boards by type: private, public, or share.
workspace_ids	array	No	List of workspace IDs to filter boards by workspace.
hierarchy_type	array	No	Filter boards by hierarchy type: classic, multi_level, or both.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error if any occurred during the execution of the action.
successful	boolean	Yes	Whether or not the action execution was successful.

Create a Monday board

MONDAY_CREATE_BOARD

Creates a Monday.com board; template_id if used must be accessible, and folder_id must be in workspace_id if both are provided.

Input parameters

Name	Type	Required	Description
board_name	string	Yes	The name for the new board.
board_kind	string	Yes	The kind of board to create: public, private, or share.
workspace_id	integer	No	Numeric ID of the workspace for the board. If omitted, the board is created in the default workspace.
folder_id	integer	No	ID of the folder for the board within the workspace.
description	string	No	Description for the new board.
template_id	integer	No	ID of an accessible template to use for the new board.
board_owner_ids	array	No	User IDs to be assigned as owners of the board.
board_subscriber_ids	array	No	User IDs to be subscribed to the board.
board_subscriber_teams_ids	array	No	Team IDs to be subscribed to the board.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error if any occurred during the execution of the action.
successful	boolean	Yes	Whether or not the action execution was successful.

Archive board

MONDAY_ARCHIVE_BOARD

Archives a specified, existing, and unarchived board in Monday.com; archived boards can typically be restored later.

Input parameters

Name	Type	Required	Description
board_id	integer	Yes	Identifier of the board to be archived; it must exist and not already be archived.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error if any occurred during the execution of the action.
successful	boolean	Yes	Whether or not the action execution was successful.

Delete board

MONDAY_DELETE_BOARD

Tool to permanently delete a board from your Monday.com account. This action cannot be undone.

Input parameters

Name	Type	Required	Description
board_id	integer	Yes	The unique identifier of the board to be deleted.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error if any occurred during the execution of the action.
successful	boolean	Yes	Whether or not the action execution was successful.

Duplicate board

MONDAY_DUPLICATE_BOARD

Tool to duplicate a Monday.com board with its structure and optionally items and updates. Duplication is asynchronous and may take time to complete for large boards.

Input parameters

Name	Type	Required	Description
board_id	integer	Yes	The unique identifier of the board to duplicate.
duplicate_type	string	Yes	Specifies what to include in the duplicate: duplicate_board_with_structure (structure only), duplicate_board_with_pulses (structure and items), or duplicate_board_with_pulses_and_updates (structure, items, and updates).
board_name	string	No	Name for the new board. If omitted, a name will be auto-generated.
workspace_id	integer	No	Destination workspace ID.
folder_id	integer	No	Destination folder ID within the workspace.
keep_subscribers	boolean	No	Whether to copy subscribers from the original board. Defaults to false.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error if any occurred during the execution of the action.
successful	boolean	Yes	Whether or not the action execution was successful.

Get board columns

MONDAY_COLUMNS

Tool to retrieve column metadata from boards via the GraphQL API. Returns array of column information including type, title, settings, and capabilities.

Input parameters

Name	Type	Required	Description
board_ids	array	Yes	Array of board IDs to retrieve columns from. Must provide at least one board ID.
column_ids	array	No	Optional array of specific column IDs to filter.
column_types	array	No	Optional array of column types to filter. Available types: auto_number, button, checkbox, date, dropdown, email, file, numbers, people, phone, status, text, timeline, and more.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error if any occurred during the execution of the action.
successful	boolean	Yes	Whether or not the action execution was successful.

Create group

MONDAY_CREATE_GROUP

Creates a new group with the given group_name on an existing Monday.com board, identified by its board_id.

Input parameters

Name	Type	Required	Description
board_id	string	Yes	The unique identifier of the Monday.com board where the new group will be created.
group_name	string	Yes	The desired name for the new group to be created on the board.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error if any occurred during the execution of the action.
successful	boolean	Yes	Whether or not the action execution was successful.

List groups

MONDAY_LIST_GROUPS

Tool to retrieve all groups of a specified board. Response is nested under data → boards[0] → groups.

Input parameters

Name	Type	Required	Description
board_id	integer	Yes	The unique identifier of the board from which to retrieve groups.
group_ids	array	No	Optional list of specific group IDs to filter the results. Invalid or non-existent group IDs silently return an empty array.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error if any occurred during the execution of the action.
successful	boolean	Yes	Whether or not the action execution was successful.

Delete group

MONDAY_DELETE_GROUP

Permanently deletes an existing group (and its items) from an existing board in Monday.com.

Input parameters

Name	Type	Required	Description
board_id	integer	Yes	Unique identifier of the board containing the group.
group_id	string	Yes	Unique identifier of the group to delete.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error if any occurred during the execution of the action.
successful	boolean	Yes	Whether or not the action execution was successful.

Create item

MONDAY_CREATE_ITEM

Creates a new item on a Monday.com board, optionally assigning it to a group and setting column values.

Input parameters

Name	Type	Required	Description
board_id	string	Yes	The board’s unique identifier. Note: Subitems boards are not supported for this action; use create_subitem mutation instead.
item_name	string	Yes	Name of the new item. Maximum length is 256 characters.
group_id	string	No	Optional group ID where the item will be created.
column_values	string	No	Column values for the new item. Accepts either a JSON string or an object/dict. For date columns, use nested structure: {"date": {"date": "YYYY-MM-DD"}}. For status columns, use index or label: {"status": {"index": 0}}.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error if any occurred during the execution of the action.
successful	boolean	Yes	Whether or not the action execution was successful.

Get items page

MONDAY_ITEMS_PAGE

Tool to retrieve items from a Monday.com board (or group) with server-side filtering, full column_values, and cursor-based pagination. Use when you need paginated access to board items with detailed column data and optional filtering/sorting.

Input parameters

Name	Type	Required	Description
board_id	integer	No	The board’s unique identifier. Required for initial fetch (when cursor is not provided).
limit	integer	No	Number of items to return per page. Default is 25, maximum is 500.
cursor	string	No	Opaque pagination cursor from previous response. Cursors are cached for 60 minutes.
group_id	string	No	Optional group ID to filter items within a specific group. Only used for initial fetch.
query_params	object	No	Query parameters for filtering and sorting items.
include_column_values	boolean	No	Whether to include column_values in the response.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error if any occurred during the execution of the action.
successful	boolean	Yes	Whether or not the action execution was successful.

Get items by IDs

MONDAY_GET_ITEMS

Tool to retrieve specific items by their IDs from Monday.com, returning metadata including name, timestamps, state, board, and group information.

Input parameters

Name	Type	Required	Description
ids	array	Yes	Array of item IDs to retrieve. Maximum of 100 IDs at one time.
page	integer	No	Page number for pagination, starting at 1.
limit	integer	No	Number of items to return. Default is 25, maximum is 100.
newest_first	boolean	No	When true, orders the results with recently created items first.
exclude_nonactive	boolean	No	When true, filters out inactive, deleted, or orphaned items from the results.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error if any occurred during the execution of the action.
successful	boolean	Yes	Whether or not the action execution was successful.

List items by column values

MONDAY_LIST_ITEMS_BY_COLUMN_VALUES

Tool to search for items on a Monday.com board based on column values. Use when you need to find items matching specific column criteria (e.g., status=“Done”, name contains “Task 1”).

Input parameters

Name	Type	Required	Description
board_id	string	Yes	The board’s unique identifier. Required for all requests.
columns	array	No	Array of column filters to search by. Required for initial request (when cursor is not provided). Uses AND logic between filters.
limit	integer	No	Number of items to return per page. Default is 25, maximum is 500.
cursor	string	No	Opaque pagination cursor from previous response. When provided, columns parameter is ignored.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error if any occurred during the execution of the action.
successful	boolean	Yes	Whether or not the action execution was successful.

Archive item

MONDAY_ARCHIVE_ITEM

Archives an existing Monday.com item, moving it from active board views to the archive where it can be potentially restored.

Input parameters

Name	Type	Required	Description
item_id	integer	Yes	Unique identifier of the Monday.com item to archive.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error if any occurred during the execution of the action.
successful	boolean	Yes	Whether or not the action execution was successful.

Delete item

MONDAY_DELETE_ITEM

Permanently deletes an existing Monday.com item; this action is irreversible via the API.

Input parameters

Name	Type	Required	Description
item_id	string	Yes	The unique identifier of the Monday.com item to be deleted.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error if any occurred during the execution of the action.
successful	boolean	Yes	Whether or not the action execution was successful.

Duplicate item

MONDAY_DUPLICATE_ITEM

Duplicates an item on a Monday.com board, optionally including its updates.

Input parameters

Name	Type	Required	Description
item_id	integer	Yes	The unique identifier of the item to be duplicated.
board_id	integer	Yes	The unique identifier of the board containing the item to be duplicated.
with_updates	boolean	No	If true, item updates (e.g., comments, replies) are duplicated with the item.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error if any occurred during the execution of the action.
successful	boolean	Yes	Whether or not the action execution was successful.

Move item to group

MONDAY_MOVE_ITEM_TO_GROUP

Moves an item to a different group on the same Monday.com board; the item and group must exist.

Input parameters

Name	Type	Required	Description
item_id	integer	Yes	The unique identifier of the item to be moved.
group_id	string	Yes	The unique identifier of the target group where the item will be moved.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error if any occurred during the execution of the action.
successful	boolean	Yes	Whether or not the action execution was successful.

Update item

MONDAY_UPDATE_ITEM

Tool to update an existing item’s column value on Monday.com. Use when setting complex column types like Timeline or People.

Input parameters

Name	Type	Required	Description
item_id	string	Yes	ID of the item to update.
board_id	string	Yes	ID of the board containing the item.
column_id	string	Yes	The unique identifier of the column to change.
value	string	Yes	New column value as a JSON-serializable object or string. For text/number/name columns, send a plain string; for complex columns like status/timeline/people, send a JSON object (e.g., {"index": 1}).
create_labels_if_missing	boolean	No	If true, creates missing labels for Status/Dropdown columns. Requires permission to change board structure.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error if any occurred during the execution of the action.
successful	boolean	Yes	Whether or not the action execution was successful.

Change simple column value

MONDAY_CHANGE_SIMPLE_COLUMN_VALUE

Changes a specific column’s value for a Monday.com item using a simple string, suitable for Text, Status, or Dropdown columns; can create new labels if create_labels_if_missing is true for Status/Dropdown columns.

Input parameters

Name	Type	Required	Description
item_id	integer	Yes	The unique identifier of the item for which the column value will be updated.
board_id	integer	Yes	The unique identifier of the board where the item and column are located.
column_id	string	Yes	Identifier of the column to change; typically a Text, Status, or Dropdown column.
value	string	Yes	New string value. For Status columns: use either a label name (e.g., Done) or an index number as string (e.g., 1). For Dropdown columns: use the label name. For Text columns: use plain text.
create_labels_if_missing	boolean	No	For Status/Dropdown columns: when true (default), the label will be matched or created if it doesn’t exist.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error if any occurred during the execution of the action.
successful	boolean	Yes	Whether or not the action execution was successful.

Create update

MONDAY_CREATE_UPDATE

Tool to create a new update for an item or reply to an existing update. Use after determining the target item or update to comment on.

Input parameters

Name	Type	Required	Description
body	string	Yes	The update’s text content.
item_id	integer	No	ID of the item to post the update on.
parent_id	integer	No	ID of the parent update to reply under.
use_app_info	boolean	No	If true, attribute the update to the app rather than the current user (API version 2025-10+).
mentions_list	array	No	List of entities to mention in the update.
original_creation_date	string	No	Original creation date in DD-MM-YYYY format (API version 2025-10+).

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error if any occurred during the execution of the action.
successful	boolean	Yes	Whether or not the action execution was successful.

Edit update

MONDAY_EDIT_UPDATE

Tool to modify the text content of an existing update on an item. Use when you need to correct or change a previously posted update.

Input parameters

Name	Type	Required	Description
id	integer	Yes	The update’s unique identifier.
body	string	Yes	The update’s new text content.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error if any occurred during the execution of the action.
successful	boolean	Yes	Whether or not the action execution was successful.

Get item updates

MONDAY_GET_UPDATES

Tool to retrieve updates for a specific item. Use when you need to fetch the conversation history tied to an item.

Input parameters

Name	Type	Required	Description
item_id	string	Yes	The unique identifier of the item to fetch updates for.
page	integer	No	Page number for pagination (starts at 1).
limit	integer	No	Number of updates to return per page (max 100, default 25).

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error if any occurred during the execution of the action.
successful	boolean	Yes	Whether or not the action execution was successful.

Create notification

MONDAY_CREATE_NOTIFICATION

Tool to send a notification to a user. Use when you need to alert a user about a board, item, or update.

Input parameters

Name	Type	Required	Description
text	string	Yes	The notification text to display.
user_id	integer	Yes	The recipient user’s unique identifier.
target_id	integer	Yes	The target’s unique identifier. If target_type is Post, use an update or reply ID; if Project, use an item or board ID.
target_type	string	Yes	The notification target type: Post for updates/replies or Project for items/boards.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error if any occurred during the execution of the action.
successful	boolean	Yes	Whether or not the action execution was successful.

List users

MONDAY_LIST_USERS

Retrieves a list of users from Monday.com. Paginate by starting at page=1, incrementing page on each request, and stopping when the returned user list is empty.

Input parameters

Name	Type	Required	Description
page	integer	No	Page number for results; starts at 1.
limit	integer	No	Maximum number of users to return per page.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error if any occurred during the execution of the action.
successful	boolean	Yes	Whether or not the action execution was successful.

Get current user

MONDAY_GET_ME

Tool to fetch the current authenticated user’s profile and permissions. Use when you need to retrieve user metadata before performing other operations.

Input parameters

Name	Type	Required	Description
api_version	string	No	Optional Monday API version header (e.g., 2025-04). Overrides default if provided.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error if any occurred during the execution of the action.
successful	boolean	Yes	Whether or not the action execution was successful.

Get workspaces

MONDAY_GET_WORKSPACES

Tool to retrieve workspaces. Use when you need to list workspaces with optional filtering, pagination, or ordering after authentication.

Input parameters

Name	Type	Required	Description
ids	array	No	List of specific workspace IDs to return.
kind	string	No	Filter by workspace kind: open or closed.
page	integer	No	Pagination page number; starts at 1.
limit	integer	No	Maximum number of workspaces to return. Default is 25.
state	string	No	Filter by workspace state: active, all, archived, or deleted.
order_by	string	No	Field to order by. Currently only created_at is supported.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error if any occurred during the execution of the action.
successful	boolean	Yes	Whether or not the action execution was successful.

Retrieve Monday docs

MONDAY_DOCS

Tool to retrieve Monday.com document data via the API. Use when you need to fetch documents with filtering by IDs, object IDs, workspace IDs, or with pagination support.

Input parameters

Name	Type	Required	Description
ids	array	No	List of document IDs to retrieve.
page	integer	No	Page number for pagination. Starts at 1.
limit	integer	No	Maximum number of documents to retrieve per page (1–100). Defaults to 25.
order_by	string	No	Field to order results by: created_at or used_at. Newest first by default.
object_ids	array	No	List of object IDs (board or item IDs) associated with the documents.
workspace_ids	array	No	List of workspace IDs to filter documents.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error if any occurred during the execution of the action.
successful	boolean	Yes	Whether or not the action execution was successful.

Create doc

MONDAY_CREATE_DOC

Tool to create a new doc in Monday.com. Use when you need to add a doc to a workspace or into a doc column on an item.

Input parameters

Name	Type	Required	Description
workspace_id	integer	No	ID of the workspace where the doc will be created. Required with name and kind for workspace location.
name	string	No	Title of the new doc. Required with workspace_id and kind for workspace location.
kind	string	No	Access level of the new doc in workspace: private, public, or share.
item_id	integer	No	ID of the item containing the doc column. Required with column_id for board location.
column_id	string	No	ID of the monday doc column on the item (e.g., monday_doc). Required with item_id for board location.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error if any occurred during the execution of the action.
successful	boolean	Yes	Whether or not the action execution was successful.

Get account info

MONDAY_GET_ACCOUNT_INFO

Retrieve account metadata and settings for the authenticated Monday.com account, including account name, slug, tier, active member count, calendar preferences, and billing plan details. Requires the account:read OAuth scope.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error if any occurred during the execution of the action.
successful	boolean	Yes	Whether or not the action execution was successful.

Upload asset

MONDAY_UPLOAD_ASSET

Tool to upload a file to an update or file column. File attachments are permanent and irreversible; confirm with the user before uploading.

Input parameters

Name	Type	Required	Description
file	object	Yes	File to upload.
target	string	Yes	Where to upload the file. Use update to attach the file to an existing update/comment, or column to upload to a file column on an item.
item_id	integer	No	The numeric ID of the item containing the file column. Required when target is column.
column_id	string	No	The ID of the file column to upload to. Required when target is column.
update_id	integer	No	The numeric ID of the update (comment) to attach the file to. Required when target is update.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error if any occurred during the execution of the action.
successful	boolean	Yes	Whether or not the action execution was successful.