Monday

Monday is a cloud-based platform that allows companies to create their own applications and work management software. The Monday component allows managing boards and items within a Monday account.

API Documentation¶

This component was built using the Monday GraphQL API, currently utilizing version 2026-01.

Connections¶

API Key {#apikey}¶

Authenticate requests using an API key.

For testing purposes, an API Key connection can be used to authenticate requests to the Monday GraphQL API.

Prerequisites¶

A Monday account with access to personal API token settings
For production integrations, OAuth 2.0 is recommended over API key authentication

Setup Steps¶

Log in to Monday and navigate to the user profile menu in the top-right corner
Select Administration or open the user profile and go to Developers > My Access Tokens
Copy the personal API token displayed on the page
For more information, refer to the Monday authentication documentation

Configure the Connection¶

Create a connection of type API Key and enter:

API Key: The personal API token copied from the Monday account settings

Input	Comments	Default
API Key	The Monday.com API key used for authentication. Generate one from the Monday.com account settings.

OAuth 2.0 {#oauth}¶

Authenticate using OAuth 2.0.

To use OAuth 2.0 authentication with Monday, register a Monday app in the Monday developer portal.

Prerequisites¶

A Monday account with developer access
Access to the Monday App Framework

Setup Steps¶

Navigate to the Monday Developer Center and create a new app
In the app settings, select OAuth and configure the OAuth settings:
Add https://oauth2.arenasolutions.com/callback as the Redirect URL in the app's OAuth configuration
Under Permissions, select the required OAuth scopes for the integration
Copy the Client ID and Client Secret from the app's OAuth section
For scope reference, see Monday's OAuth 2.0 documentation

Configure the Connection¶

Create a connection of type OAuth 2.0 and enter:

Client ID: The Client ID from the Monday app
Client Secret: The Client Secret from the Monday app
Scopes: The OAuth permission scopes required for the integration (space-separated). Refer to Monday's OAuth 2.0 documentation for available scopes

This connection uses OAuth 2.0, a common authentication mechanism for integrations. Read about how OAuth 2.0 works here.

Input	Comments	Default
Scopes	Space-separated list of OAuth 2.0 permission scopes for Monday. See Monday.com OAuth scopes.	account:read assets:read boards:read boards:write me:read notifications:write tags:read teams:read updates:read updates:write users:read users:write webhooks:read webhooks:write workspaces:read workspaces:write
Client ID	The Client ID from the Monday.com OAuth application credentials.
Client Secret	The Client Secret from the Monday.com OAuth application credentials.

Triggers¶

Webhook {#webhook}¶

Receives webhook events from Monday.com. Automatically creates and deletes webhook subscriptions on instance deploy and delete.

Input	Comments	Default
Connection	The Monday.com connection to use.
Board ID	The unique identifier of the Monday.com board.
Event	The type of board event to subscribe to.
Config	Optional event-specific configuration as a JSON object. For example, {"columnId": "status"} for change_specific_column_value events.
Signing Secret	The Signing Secret from your Monday.com app. When provided, webhook payloads are verified against this secret. See Monday.com Authorization docs for details.

Actions¶

Archive Board {#archiveboard}¶

Archives a board by ID.

Input	Comments	Default
Connection	The Monday.com connection to use.
Board ID	The unique identifier of the Monday.com board.

Create Board {#createboard}¶

Creates a new board in Monday.

Input	Comments	Default
Connection	The Monday.com connection to use.
Board Name	The display name of the Monday.com board to create.
Board Kind	The visibility level of the board. Public boards are visible to all team members; private boards are restricted to invited members; shareable boards can be shared with guests.
Folder ID	The unique identifier of the folder in which the board will be created.
Workspace ID	The unique identifier of the workspace where the board will be created.
Template ID	The unique identifier of the Monday.com template the board is based on.

Create Webhook {#createwebhook}¶

Creates a webhook subscription for a board event.

Input	Comments	Default
Connection	The Monday.com connection to use.
Board ID	The unique identifier of the Monday.com board.
Webhook URL	The URL to receive webhook events. Must be a publicly accessible HTTPS endpoint (255 character limit).
Event	The type of board event to subscribe to.
Config	Optional event-specific configuration as a JSON object. For example, {"columnId": "status"} for change_specific_column_value events.

Delete Webhook {#deletewebhook}¶

Deletes an existing webhook subscription by ID.

Input	Comments	Default
Connection	The Monday.com connection to use.
Board ID	The unique identifier of the Monday.com board.
Webhook ID	The unique identifier of the Monday.com webhook.

Generic GraphQL Request {#genericrequest}¶

Issue any GraphQL query or mutation with variables.

Input	Comments	Default
Connection	The Monday.com connection to use.
Query or Mutation	The GraphQL query or mutation to execute against the Monday.com API.	`{ me { id email } }`
Variables	Key-value pairs of variables to pass to the GraphQL query or mutation. Use this for simple variable input.
Variables Object	A JSON object of variables to pass to the GraphQL query or mutation. Use this for structured variable input.
API Version	The Monday.com API version to use. If not provided, the default 2026-01 version will be used.

Get Board {#getboard}¶

Get the information and metadata of a board by ID.

Input	Comments	Default
Connection	The Monday.com connection to use.
Board ID	The unique identifier of the Monday.com board.

Get Items By Column Value {#getitemsbycolumnvaluenew}¶

Fetch items that have a certain column value.

Input	Comments	Default
Connection	The Monday.com connection to use.
Board ID	The unique identifier of the Monday.com board.
Column ID	The ID of the column to filter by. For possible values see the Monday.com column types reference.
Column Value	The value to match against the specified column when searching for items.
Get All Items	When true, automatically fetches all pages of items matching the column value. When false, a maximum of 500 items will be returned.	false

Get Items By Column Value (Deprecated) {#getitemsbycolumnvalue}¶

Fetch items that have a certain column value. This version of the action is being deprecated. Please replace action with Get Items By Column Value.

Input	Comments	Default
Connection	The Monday.com connection to use.
Board ID	The unique identifier of the Monday.com board.
Column ID	The ID of the column to filter by. For possible values see the Monday.com column types reference.
Column Value	The value to match against the specified column when searching for items.

List Boards {#listboards}¶

Lists all available boards in the Monday account.

Input	Comments	Default
Connection	The Monday.com connection to use.
Result Limit	The maximum number of results to return. Accepts a value from 1 to 500.
Page Offset	The page number to retrieve from paginated results. Uses 1-based indexing.
Fetch All	When true, automatically fetches all pages of results using pagination. Ignores the Result Limit and Page Offset inputs.	false

List Webhooks {#listwebhooks}¶

Lists all webhook subscriptions for a board.

Input	Comments	Default
Connection	The Monday.com connection to use.
Board ID	The unique identifier of the Monday.com board.