Monday Component
Manage boards, tasks and workflows within Monday.
Component key: monday
Description
Monday is a Cloud-based platform that allows companies to create their own applications and work management software. The Monday component allows you to manage columns, items, and subscribers in a Monday board.
Monday offers a GraphQL-based API and was built using the Monday API Reference Version 2025-04. This gives you flexibility and control over what data you send to Monday, and what data you request back.
While this component offers some actions that wrap common GraphQL queries and mutations, there are many more queries and mutations for which there aren't dedicated actions. If you'd like to run a query or mutation that is not represented by an action, please use the Generic GraphQL Request action.
Connections
API Key
For testing purposes, you can use an API key to authenticate requests to the Monday GraphQL API. You can configure a Monday Personal API token from your user admin settings. For more information refer to the Monday documentation. We recommend using OAuth when you deploy your integration to customers.
| Input | Notes | Example |
|---|---|---|
| API Key | API Key |
OAuth 2.0
To configure OAuth 2.0 you will first need to register a Monday app. Ensure that the callback URL is added to the app in Monday.
Now you will need to add the Monday component's OAuth 2.0 connection to your integration and configure it with:
- For Client ID and Client Secret enter the values that you got from your Monday app.
- For Scopes refer to Monday's OAuth 2.0 documentation.
| Input | Notes | Example |
|---|---|---|
| Authorize URL | The OAuth 2.0 Authorization URL for Monday | https://auth.monday.com/oauth2/authorize |
| Client ID | Client Identifier of your app for Monday | |
| Client Secret | Client Secret of your app for Monday | |
| Scopes | Space separated OAuth 2.0 permission scopes for Monday. See https://developer.monday.com/apps/docs/oauth#set-up-permission-scopes. | me:read boards:read |
| Token URL | The OAuth 2.0 Token URL for Monday | https://auth.monday.com/oauth2/token |
Data Sources
Select Board
Select a board from the list of boards | key: selectBoard | type: picklist
| Input | Notes | Example |
|---|---|---|
| Connection |
Actions
Archive Board
Delete the information and metadata of a board by Id | key: archiveBoard
| Input | Notes | Example |
|---|---|---|
| Board ID | Provide the unique identifier of the board | |
| Connection |
{
"data": {
"archive_board": {
"id": "4277545378"
}
}
}
Create Board
Create a new board inside your Monday account | key: createBoard
| Input | Notes | Example |
|---|---|---|
| Board Kind | Provide a string value for the kind of board. | public |
| Board Name | Provide a string value for the name of the board. | |
| Connection | ||
| Folder ID | Provide the unique identifier of the folder. | |
| Template ID | Provide the unique identifier of the template that your board extends. | |
| Workspace ID | Provide the unique identifier of the workspace. |
{
"data": {
"create_board": {
"id": "4277545378"
}
}
}
Generic GraphQL Request
Issue any GraphQL query or mutation with variables | key: genericRequest
| Input | Notes | Example |
|---|---|---|
| API Version | Provide the version of the API you want to use. If none provided, the default 2025-07 version will be used. | 2025-07 |
| Connection | ||
| Query or Mutation | ||
| Variables | ||
| Variables Object |
Get Board
Get the information and metadata of a board by ID | key: getBoard
| Input | Notes | Example |
|---|---|---|
| Board ID | Provide the unique identifier of the board | |
| Connection |
{
"data": {
"boards": [
{
"id": "2924980809",
"name": "H2 Kickoff",
"state": "active",
"board_folder_id": null,
"columns": [
{
"title": "Name",
"type": "name"
},
{
"title": "Person",
"type": "multiple-person"
},
{
"title": "Status",
"type": "color"
},
{
"title": "Date",
"type": "date"
}
],
"creator": {
"id": 32002207
}
}
]
}
}
Get Items By Column Value
Fetch items that have a certain column value. | key: getItemsByColumnValueNew
| Input | Notes | Example |
|---|---|---|
| Board ID | Provide the unique identifier of the board | |
| Column ID | Provide the ID of the column. For possible values see https://developer.monday.com/api-reference/reference/column-types-reference#supported-columns. | status |
| Column Value | The column's value to search items by | |
| Connection | ||
| Get All Items | If turned off, a maximum of 500 items will be returned. | false |
{
"data": {
"items_by_column_values": [
{
"id": "12345678912",
"name": "task #1",
"creator": {
"email": "example@email.com"
},
"updated_at": "2024-02-23T15:23:39Z",
"state": "active",
"column_values": [
{
"id": "person",
"text": "John Doe",
"column": {
"description": null,
"title": "Person"
},
"type": "people",
"value": "{\"personsAndTeams\":[{\"id\":12345678,\"kind\":\"person\"}]}"
},
{
"id": "status",
"text": "Working on it",
"column": {
"description": null,
"title": "Status"
},
"type": "status",
"value": "{\"index\":0,\"post_id\":null,\"changed_at\":\"2019-03-01T17:24:57.321Z\"}"
},
{
"id": "date4",
"text": "2022-07-12",
"column": {
"description": null,
"title": "Date"
},
"type": "date",
"value": "{\"date\":\"2022-07-12\",\"icon\":null,\"changed_at\":\"2022-07-11T20:27:58.362Z\"}"
},
{
"id": "text",
"text": "This is a text column",
"column": {
"description": null,
"title": "Text"
},
"type": "text",
"value": "\"This is a text column\""
},
{
"id": "country",
"text": "United States",
"column": {
"description": null,
"title": "Country"
},
"type": "country",
"value": "{\"changed_at\":\"2024-02-23T15:23:39.043Z\",\"countryCode\":\"US\",\"countryName\":\"United States\"}"
}
]
}
]
}
}
Get Items By Column Value (Deprecated)
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. | key: getItemsByColumnValue
| Input | Notes | Example |
|---|---|---|
| Board ID | Provide the unique identifier of the board | |
| Column ID | Provide the ID of the column. For possible values see https://developer.monday.com/api-reference/reference/column-types-reference#supported-columns. | status |
| Column Value | The column's value to search items by | |
| Connection |
{
"data": {
"items_by_column_values": [
{
"id": "4277581981",
"name": "Task 1",
"creator": {
"email": "example@email.com"
},
"updated_at": "2023-04-10T16:23:17Z",
"state": "active",
"column_values": [
{
"id": "numbers",
"text": "1234",
"title": "Some Numbers",
"value": "\"1234\"",
"description": null,
"type": "numeric"
},
{
"id": "item_id",
"text": "4277581981",
"title": "Item ID",
"value": null,
"description": null,
"type": "pulse-id"
},
{
"id": "text",
"text": "Hi There",
"title": "Text",
"value": "\"Hi There\"",
"description": null,
"type": "text"
}
]
}
]
}
}
List Boards
List all available boards in your Monday account | key: listBoards
| Input | Notes | Example |
|---|---|---|
| Connection | ||
| Fetch All | Turn on to fetch all items from the board. This will ignore the Result Limit and Page Offset inputs. | false |
| Result Limit | Provide an integer value for the maximum amount of results that will be returned. Provide a value from 1 to 500. | 20 |
| Page Offset | Provide an integer value for the page offset for the given object's results. | 3 |
{
"data": {
"boards": [
{
"id": "2924980809",
"name": "Example Board",
"state": "active",
"board_folder_id": null,
"creator": {
"id": 32002207
}
}
]
}
}
Changelog
2025-08-19
Updated API version configuration across all Monday actions to use version 2025-07.
2025-07-22
Updated to latest Monday API version with improved functionality.
2025-07-11
Added inline data source for board selection and GraphQL fragment support for advanced queries.
2025-04-01
Updated to Monday API version 2025-04 with enhanced board and item management capabilities.