Monday Connector
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
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
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.integrations.acme.com/callbackas the Redirect URL in the app's OAuth configuration
- Add
- 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
New and Updated Items
Polls a Monday.com board for items created or updated since the last execution, separated into new and updated buckets.
| Input | Comments | Default |
|---|---|---|
| Connection | The Monday.com connection to use. | |
| Board ID | The unique identifier for the Monday.com board that the action targets. | |
| Show New Records | When true, newly created items are included in the trigger output. | true |
| Show Updated Records | When true, items updated since the last poll are included in the trigger output. | true |
Webhook
Receive webhook events from Monday. Automatically creates and manages webhook subscriptions on instance deploy and removes them on instance delete.
| Input | Comments | Default |
|---|---|---|
| Connection | The Monday.com connection to use. | |
| Board ID | The unique identifier for the Monday.com board that the action targets. | |
| 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 the Monday.com app. When provided, webhook payloads are verified against this secret. See Monday.com Authorization docs for details. |
Actions
Archive Board
Archives a board by ID.
| Input | Comments | Default |
|---|---|---|
| Connection | The Monday.com connection to use. | |
| Board ID | The unique identifier for the Monday.com board that the action targets. |
Create Board
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
Creates a webhook subscription for a board event.
| Input | Comments | Default |
|---|---|---|
| Connection | The Monday.com connection to use. | |
| Board ID | The unique identifier for the Monday.com board that the action targets. | |
| 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
Deletes an existing webhook subscription by ID.
| Input | Comments | Default |
|---|---|---|
| Connection | The Monday.com connection to use. | |
| Board ID | The unique identifier for the Monday.com board that the action targets. | |
| Webhook ID | The unique identifier of the Monday.com webhook. |
Generic GraphQL Request
Issues 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. | |
| 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
Gets the information and metadata of a board by ID.
| Input | Comments | Default |
|---|---|---|
| Connection | The Monday.com connection to use. | |
| Board ID | The unique identifier for the Monday.com board that the action targets. |
Get Items By Column Value
Fetches items that have a certain column value.
| Input | Comments | Default |
|---|---|---|
| Connection | The Monday.com connection to use. | |
| Board ID | The unique identifier for the Monday.com board that the action targets. | |
| 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)
Fetches items that have a certain column value. This version of the action is deprecated. Please use Get Items By Column Value instead.
| Input | Comments | Default |
|---|---|---|
| Connection | The Monday.com connection to use. | |
| Board ID | The unique identifier for the Monday.com board that the action targets. | |
| 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
Lists all available boards in the Monday account.
| Input | Comments | Default |
|---|---|---|
| Connection | The Monday.com connection to use. | |
| Fetch All | When true, automatically fetches all pages of results using pagination. Ignores the Result Limit and Page Offset inputs. | false |
| 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. |
List Webhooks
Lists all webhook subscriptions for a board.
| Input | Comments | Default |
|---|---|---|
| Connection | The Monday.com connection to use. | |
| Board ID | The unique identifier for the Monday.com board that the action targets. |