> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stackone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Monday.com Webhook Setup Guide

> Configure Monday.com to deliver events to StackOne.

## Prerequisites

The connector should already be set up, with a Connector Profile and a Linked Account. See [Getting Started](https://docs.stackone.com/connectors/monday.md#getting-started) on the Monday.com connector page.

## Enable webhook events

StackOne creates the monday.com webhooks for you when the account is connected, and removes\
them when it is disconnected. You do not paste a URL anywhere — you only tell StackOne which\
boards to watch, and make sure the connection is allowed to manage webhooks.

**1. Copy the board IDs into this connection**

monday.com creates every webhook on a single board, so StackOne needs the ID of each board\
you want events from. Sign in to your [monday.com account](https://auth.monday.com/auth/login_monday)\
and open a board. The board ID is the number at the end of the address.

<ul>
  <li>Format: `https://{account}.monday.com/boards/{board ID}`</li>
  <li>Repeat for every board you want events from.</li>
  <li>Enter the IDs in **Webhook Board IDs** on the connection, separated by commas, with no spaces.</li>
  <li>Example: `5032433907,5032438875`</li>
</ul>

![A monday.com board with the board ID in the browser address bar highlighted](https://mintcdn.com/stackone-60/5LjHa5qM1RZ1ZAUd/connectors/monday/images/board-id-url.png?fit=max\&auto=format\&n=5LjHa5qM1RZ1ZAUd\&q=85\&s=6177ecf8b6def61be44fbc0523ad49df)

**2. Find several board IDs at once**

If you are listing many boards, the Developer Center can return every board ID with its\
name in one query.

<ul>
  <li>Click your profile picture in the top right corner, then select **Developers**.</li>
  <li>Click **API playground** in the left sidebar.</li>
  <li>Run `query { boards (limit: 10) { id name } }` and read the IDs from the response.</li>
  <li>Ignore any board named **Subitems of …** — list the board holding the parent items instead.</li>
</ul>

![The API playground with the boards query run and the returned board IDs highlighted](https://mintcdn.com/stackone-60/5LjHa5qM1RZ1ZAUd/connectors/monday/images/board-ids-playground.png?fit=max\&auto=format\&n=5LjHa5qM1RZ1ZAUd\&q=85\&s=db8ff792982fa943d4c50ddc4be5df72)

**3. Turn on subitems where you need subitem events**

monday.com rejects the six subitem event subscriptions on a board that has no subitems\
column. It does so silently — every other event is still created, so the board simply never\
sends subitem events.

<ul>
  <li>Open a board listed in **Webhook Board IDs** and add one subitem to any item.</li>
  <li>Only the board holding the parent items needs this. Do not list the subitems board that monday.com creates alongside it.</li>
</ul>

**4. Check the connection can manage webhooks**

StackOne calls monday.com's webhook API as the connected account, so that account has to be\
allowed to create automations on each board.

<ul>
  <li>**API Token connections**: the token already carries your own permissions, so nothing more is needed.</li>
  <li>**OAuth 2.0 connections**: the app needs the `webhooks:read` and `webhooks:write` scopes. monday.com locks an app version's scopes once it is promoted, so adding them means a new app version and reconnecting the account.</li>
  <li>A board that refuses webhook creation is skipped and the rest still connect, so check each board you listed is receiving events.</li>
</ul>

## Available webhook events

The following monday.com events can be enabled. Only events selected in StackOne are subscribed\
— monday.com does not deliver events that are not subscribed.

**1. Active check**

Answered automatically, and never shown as an event you need to trigger.

<ul>
  <li>**Active Check** (`challenge`) — monday.com's URL verification challenge, sent once each time a webhook is registered. StackOne echoes it back automatically; monday.com refuses to store a subscription whose URL does not answer it.</li>
</ul>

**2. Item events**

Events on the items of a subscribed board.

<ul>
  <li>**Item Created** (`create_item`) — Fired when an item is added to the board</li>
  <li>**Item Name Changed** (`change_name`) — Fired when an item is renamed</li>
  <li>**Item Archived** (`item_archived`) — Fired when an item is archived</li>
  <li>**Item Deleted** (`item_deleted`) — Fired when an item is deleted</li>
  <li>**Item Restored** (`item_restored`) — Fired when an archived item is restored from the board's archive</li>
  <li>**Item Moved To Any Group** (`item_moved_to_any_group`) — Fired when an item moves from one group to another</li>
  <li>**Item Moved To Specific Group** (`item_moved_to_specific_group`) — Fired when an item moves into one named group. monday.com needs a group filter that StackOne cannot supply, so it stays switched off in monday.com — use **Item Moved To Any Group** and read `destGroupId` from the payload</li>
</ul>

**3. Subitem events**

Events on subitems. The board must have a subitems column before monday.com will accept these subscriptions.

<ul>
  <li>**Subitem Created** (`create_subitem`) — Fired when a subitem is added under an item</li>
  <li>**Subitem Name Changed** (`change_subitem_name`) — Fired when a subitem is renamed</li>
  <li>**Subitem Column Value Changed** (`change_subitem_column_value`) — Fired when a column value changes on a subitem. monday.com accepts this subscription but does not currently deliver it</li>
  <li>**Subitem Moved** (`move_subitem`) — Fired when a subitem moves from one parent item to another</li>
  <li>**Subitem Archived** (`subitem_archived`) — Fired when a subitem is archived</li>
  <li>**Subitem Deleted** (`subitem_deleted`) — Fired when a subitem is deleted</li>
</ul>

**4. Column events**

Events on the columns of a subscribed board, and on the values in them.

<ul>
  <li>**Column Value Changed** (`change_column_value`) — Fired when any column value changes on an item</li>
  <li>**Status Column Value Changed** (`change_status_column_value`) — Fired when a status column changes to one named label. monday.com needs a column and label filter that StackOne cannot supply, so it stays switched off in monday.com — use **Column Value Changed** and read `columnId` from the payload</li>
  <li>**Specific Column Value Changed** (`change_specific_column_value`) — Fired when one named column changes. monday.com needs a column filter that StackOne cannot supply, so it stays switched off in monday.com — use **Column Value Changed** and read `columnId` from the payload</li>
  <li>**Column Created** (`create_column`) — Fired when a column is added to the board</li>
</ul>

**5. Update events**

Events on the updates posted against items and subitems.

<ul>
  <li>**Update Posted** (`create_update`) — Fired when an update is posted on an item</li>
  <li>**Subitem Update Posted** (`create_subitem_update`) — Fired when an update is posted on a subitem</li>
  <li>**Update Edited** (`edit_update`) — Fired when an existing update is edited</li>
  <li>**Update Deleted** (`delete_update`) — Fired when an update is deleted</li>
</ul>

## Verify

Your Connector should now be able to receive and process events. Try triggering an event and you should see an Event appear in the Connector logs.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.