Skip to main content

Monday Component

Manage boards, tasks and workflows within Monday.

Component key: monday

Changelog ↓

Description​

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.

Monday offers a GraphQL-based API and was built using the Monday API Reference Version 2026-01. This provides flexibility and control over what data is sent to Monday, and what data is requested 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. To run a query or mutation that is not represented by an action, use the Generic GraphQL Request action.

Connections​

API Key​

key: apiKey

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​

  1. Log in to Monday and navigate to the user profile menu in the top-right corner
  2. Select Administration or open the user profile and go to Developers > My Access Tokens
  3. Copy the personal API token displayed on the page
  4. 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
InputNotesExample
API Key

The Monday.com API key used for authentication. Generate one from the Monday.com account settings.

OAuth 2.0​

key: oauth

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

Prerequisites​

Setup Steps​

  1. Navigate to the Monday Developer Center and create a new app
  2. In the app settings, select OAuth and configure the OAuth settings:
    • Add https://oauth2.prismatic.io/callback as the Redirect URL in the app's OAuth configuration
  3. Under Permissions, select the required OAuth scopes for the integration
  4. Copy the Client ID and Client Secret from the app's OAuth section
  5. 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
InputNotesExample
Authorize URL

The OAuth 2.0 Authorization URL for Monday.

https://auth.monday.com/oauth2/authorize
Client ID

The Client ID from the Monday.com OAuth application credentials.

Client Secret

The Client Secret from the Monday.com OAuth application credentials.

Scopes

Space-separated list of OAuth 2.0 permission scopes for Monday. See Monday.com OAuth scopes.

me:read boards:read
Token URL

The OAuth 2.0 Token URL for Monday.

https://auth.monday.com/oauth2/token

Triggers​

Webhook​

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

InputNotesExample
Board ID

The unique identifier of the Monday.com board.

1234567890
Connection

The Monday.com connection to use.

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.

Config

Optional event-specific configuration as a JSON object. For example, {"columnId": "status"} for change_specific_column_value events.

Event

The type of board event to subscribe to.

Monday.com webhooks deliver real-time notifications when board events occur. This trigger automatically manages the webhook subscription lifecycle — creating a webhook endpoint in Monday.com when the instance is deployed and removing it when the instance is deleted.

How It Works​

When this trigger is used in a flow:

  • On Instance Deploy: The trigger automatically creates a webhook subscription in Monday.com pointing to the instance's unique webhook URL, subscribed to the configured board event. If a webhook for this instance already exists from a previous deploy, it is replaced with a fresh one.
  • On Instance Deletion: The trigger automatically removes the webhook subscription from Monday.com.

Each incoming request is routed to one of two branches:

  • Challenge Verification branch: Handles the initial URL verification challenge that Monday.com sends when a webhook subscription is first registered. The trigger automatically responds with the required challenge token.
  • Notification branch: Handles all subsequent event notifications from Monday.com after verification is complete.

Configuration​

Configure the following inputs:

  • Connection: The Monday.com connection (API Key or OAuth 2.0) to use for managing the webhook subscription.
  • Board ID: The ID of the Monday.com board to monitor for events. Use the Select Board data source to choose from available boards.
  • Event: The type of board event to subscribe to. Select from the available event types listed below.
  • Config: An optional JSON object for event-specific configuration (e.g., {"columnId": "status"} for change_specific_column_value events).

Event Types​

Available Events (21)
EventDescription
change_column_valueFires when any column value is changed on an item
change_status_column_valueFires when a status column value is changed
change_subitem_column_valueFires when a column value is changed on a subitem
change_specific_column_valueFires when a specific column value is changed (requires columnId in Config)
change_nameFires when an item's name is changed
create_itemFires when a new item is created on the board
item_archivedFires when an item is archived
item_deletedFires when an item is deleted
item_moved_to_any_groupFires when an item is moved to any group
item_moved_to_specific_groupFires when an item is moved to a specific group
item_restoredFires when an archived or deleted item is restored
create_subitemFires when a subitem is created
change_subitem_nameFires when a subitem's name is changed
move_subitemFires when a subitem is moved
subitem_archivedFires when a subitem is archived
subitem_deletedFires when a subitem is deleted
create_columnFires when a new column is created on the board
create_updateFires when an update (comment) is posted on an item
edit_updateFires when an update (comment) is edited
delete_updateFires when an update (comment) is deleted
create_subitem_updateFires when an update is posted on a subitem

Refer to Monday.com's webhook documentation for the complete and up-to-date list of supported events.

Returned Data​

Example Payload
{
  "event": {
    "userId": 12345678,
    "originalTriggerUuid": null,
    "boardId": 2924980809,
    "groupId": "topics",
    "pulseId": 4277581981,
    "pulseName": "Task 1",
    "columnId": "status",
    "columnType": "color",
    "columnTitle": "Status",
    "value": {
      "label": {
        "index": 1,
        "text": "Done",
        "style": {
          "color": "#00c875",
          "border": "#00b461",
          "var_name": "done-green"
        },
        "is_done": true
      }
    },
    "previousValue": {
      "label": {
        "index": 0,
        "text": "Working on it",
        "style": {
          "color": "#fdab3d",
          "border": "#e99729",
          "var_name": "working-orange"
        },
        "is_done": false
      }
    },
    "changedAt": 1737993600.123456,
    "isTopGroup": true,
    "type": "update_column_value",
    "triggerTime": "2025-01-27T12:00:00.000Z",
    "subscriptionId": 147295839,
    "triggerUuid": "abc123def456"
  }
}

Notes​

  • The Challenge Verification branch fires only once per webhook registration and does not contain board event data. Route all business logic through the Notification branch.
  • The change_specific_column_value event requires a columnId value in the Config input to identify which column to monitor.
  • Monday.com webhook payloads vary in structure depending on the event type. Refer to Monday.com's webhook event payload documentation for field definitions per event type.

Data Sources​

Select Board​

Select a board from the list of boards. | key: selectBoard | type: picklist

InputNotesExample
Connection

The Monday.com connection to use.

Select Webhook​

Select a webhook from the board's webhook subscriptions. | key: selectWebhook | type: picklist

InputNotesExample
Board ID

The unique identifier of the Monday.com board.

1234567890
Connection

The Monday.com connection to use.

Actions​

Archive Board​

Archives a board by ID. | key: archiveBoard

InputNotesExample
Board ID

The unique identifier of the Monday.com board.

1234567890
Connection

The Monday.com connection to use.

{
  "data": {
    "archive_board": {
      "id": "4277545378"
    }
  }
}

Create Board​

Creates a new board in Monday. | key: createBoard

InputNotesExample
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.

public
Board Name

The display name of the Monday.com board to create.

Project Tracker
Connection

The Monday.com connection to use.

Folder ID

The unique identifier of the folder in which the board will be created.

9876543
Template ID

The unique identifier of the Monday.com template the board is based on.

1122334
Workspace ID

The unique identifier of the workspace where the board will be created.

5566778

{
  "data": {
    "create_board": {
      "id": "4277545378"
    }
  }
}

Create Webhook​

Creates a webhook subscription for a board event. | key: createWebhook

InputNotesExample
Board ID

The unique identifier of the Monday.com board.

1234567890
Connection

The Monday.com connection to use.

Config

Optional event-specific configuration as a JSON object. For example, {"columnId": "status"} for change_specific_column_value events.

Event

The type of board event to subscribe to.

Webhook URL

The URL to receive webhook events. Must be a publicly accessible HTTPS endpoint (255 character limit).

https://hooks.example.com/monday/events

{
  "data": {
    "create_webhook": {
      "id": "147295839",
      "board_id": "2924980809",
      "event": "create_item",
      "config": null
    }
  }
}

Delete Webhook​

Deletes an existing webhook subscription by ID. | key: deleteWebhook

InputNotesExample
Board ID

The unique identifier of the Monday.com board.

1234567890
Connection

The Monday.com connection to use.

Webhook ID

The unique identifier of the Monday.com webhook.

123456789

{
  "data": {
    "delete_webhook": {
      "id": "147295839",
      "board_id": "2924980809"
    }
  }
}

Generic GraphQL Request​

Issue any GraphQL query or mutation with variables. | key: genericRequest

InputNotesExample
API Version

The Monday.com API version to use. If not provided, the default 2026-01 version will be used.

2026-01
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.

Get Board​

Get the information and metadata of a board by ID. | key: getBoard

InputNotesExample
Board ID

The unique identifier of the Monday.com board.

1234567890
Connection

The Monday.com connection to use.

{
  "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

InputNotesExample
Board ID

The unique identifier of the Monday.com board.

1234567890
Column ID

The ID of the column to filter by. For possible values see the Monday.com column types reference.

status
Column Value

The value to match against the specified column when searching for items.

Done
Connection

The Monday.com connection to use.

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

{
  "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

InputNotesExample
Board ID

The unique identifier of the Monday.com board.

1234567890
Column ID

The ID of the column to filter by. For possible values see the Monday.com column types reference.

status
Column Value

The value to match against the specified column when searching for items.

Done
Connection

The Monday.com connection to use.

{
  "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​

Lists all available boards in the Monday account. | key: listBoards

InputNotesExample
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.

20
Page Offset

The page number to retrieve from paginated results. Uses 1-based indexing.

3

{
  "data": {
    "boards": [
      {
        "id": "2924980809",
        "name": "Example Board",
        "state": "active",
        "board_folder_id": null,
        "creator": {
          "id": "32002207"
        }
      }
    ]
  }
}

List Webhooks​

Lists all webhook subscriptions for a board. | key: listWebhooks

InputNotesExample
Board ID

The unique identifier of the Monday.com board.

1234567890
Connection

The Monday.com connection to use.

{
  "data": {
    "webhooks": [
      {
        "id": "147295839",
        "board_id": "2924980809",
        "event": "create_item",
        "config": null
      },
      {
        "id": "147295840",
        "board_id": "2924980809",
        "event": "change_column_value",
        "config": "{\"columnId\":\"status\"}"
      }
    ]
  }
}

Changelog​

2026-03-19​

Added webhook support and quality of life updates:

  • Updated to Monday API version 2026-01
  • Improved input field documentation with formatted URL links for better readability
  • Webhook trigger that automatically manages webhook subscriptions on instance deploy and removal
  • Create Webhook action to create a webhook subscription for a specified board
  • Delete Webhook action to delete an existing webhook subscription by ID
  • List Webhooks action to list all webhook subscriptions for a board
  • Select Webhook data source for selecting a webhook in configuration
  • Updated OAuth 2.0 connection to support webhook permissions

2025-08-19​

Updated API version configuration across all Monday actions to use version 2025-07

2025-07-22​

Updated to Monday API version 2025-07

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