# monday.com

Create, find and update items and subitems on monday.com boards, post updates, and manage boards, groups, columns and their labels.

## Connect monday.com

1. In the sidebar, open **Connections** and press **Add connection**.
2. Type `monday.com` and choose **monday.com**.
3. Choose **Sign in with monday.com**.
4. Press **Sign in with monday.com** at the bottom of the sheet, then choose your account in monday.com’s window and allow access.

Or choose **Paste your personal API token**, paste it, and press **Test and save**. It stays until someone deletes it.

Sign in with monday.com, or paste a personal API token (your avatar → Developers → My access tokens; admins also find it under Administration → Connections → API). The token acts as you and reaches the boards you can open.

**What if it says “Sign-in isn’t set up here yet”?**

Signing in with monday.com needs a monday.com app on this installation, and it has none yet. Until it is set up, **Paste your personal API token** works without it.

**On Cloud:** The sheet says “It’s set up once for everyone who uses this service, not by an organization.”

**Self-hosted:** An admin of the installation sees **Set up monday.com sign-in** instead, and sets it up once for everyone. Everyone else sees who to ask.

1. Create an app in monday.com’s developer settings ([monday.com’s guide](https://developer.monday.com/api-reference/docs/authentication)).
2. In GoRunner, copy the **Redirect address to add in monday.com’s developer settings**, and add it to the app.
3. Paste the **Client ID** and **Client secret**, then press **Save and sign in**.

[Set up a sign-in app](https://docs.gorunner.io/self-host/oauth-apps#other-providers)

**Can I use my own monday.com app?**

Yes. In the sheet, open **Use your own monday.com app** and paste its **Client ID** and **Client secret**. Add the redirect address it shows to your app first. The connection then signs in through your app instead of the installation’s.

[Connections](https://docs.gorunner.io/build/connections) says how to sign in again, rename or delete it. In a product that embeds GoRunner, **Add connection** can be missing: then [your provider makes connections](https://docs.gorunner.io/embed/customer-connections) for you.

## Start a workflow

Add a trigger and choose **monday.com**. The trigger uses the same connection as the steps.

### On Board Event

Fires when the chosen event happens on the board. Publishing the workflow creates the board's webhook in monday.com; unpublishing removes it. Each delivery is checked against a secret only this webhook's address carries, and one without it is refused. monday retries a delivery it could not hand over for 30 minutes; a retry of the same event starts no second run. The connection's user must be able to open the board.

- **Board · Required**: The board to watch. For a subitem event, the parent board (the one with the items).
- **Event · Required**: What starts the workflow. Options: Item created to Column created (21 options). Default: Item created.
- **Column · Required**: The column whose changes start the workflow. Shows when **Event** is **A specific column's value changed**.
- **Group · Required**: The group items must move to. Shows when **Event** is **Item moved to a specific group**.

## Do things in monday.com

Add a **monday.com** step, choose a **Resource**, then an **Operation**. Choose a row to see its fields.

- [Item](https://docs.gorunner.io/apps/monday#fields-f-item): Archive or Delete · Clear Column Values · Create · Duplicate · Get · Get by Column Value · Get Column Value · Get Many · List Subscribers · Move · Search · Update
- [Board](https://docs.gorunner.io/apps/monday#fields-f-board): Aggregate Item Data · Archive or Delete · Create · Duplicate · Get · Get Many · List Activity Logs · List Subscribers · Search · Update · Update Subscribers
- [Group](https://docs.gorunner.io/apps/monday#fields-f-group): Archive or Delete · Create · Duplicate · Get Many · Update
- [Column](https://docs.gorunner.io/apps/monday#fields-f-column): Add Label · Create · Create or Get Tag · Delete · Get Many · Update · Update Label
- [Update](https://docs.gorunner.io/apps/monday#fields-f-update): Add File · Create · Delete · Get Many · Search
- [User](https://docs.gorunner.io/apps/monday#fields-f-user): Get Many

Later steps read a step’s output by its name: see [Use data from earlier steps](https://docs.gorunner.io/build/use-data-from-earlier-steps).

## Limits

- A reply from monday.com can be up to 16 MB (a file download can have its own limit). A larger one fails the step; it is never cut short.
- When monday.com says to slow down (429), the step waits as long as it asks, if the step’s time allows. Otherwise it fails and says when to try again.

Not in your list? See [When an app isn’t here](https://docs.gorunner.io/apps/when-an-app-isnt-here#q-not-in-list).

## For developers

In the API, which calls apps pieces, monday.com is `pieceId: "monday"` with `actionId: "monday"`, set by `resource` and an `operation_…` field, such as `operation_board`. Its trigger is `mondaytrigger` / `monday_event`. [Get an app](https://docs.gorunner.io/api/apps/get-app) returns every field.

It can change something outside the run (`writes_external`). See [How versions and side effects work](https://docs.gorunner.io/apps#q-versions).

### monday.com › Item

### Archive or Delete

- **Items · Optional**: One item, or several by id. Options: One item, Several items. Default: One item.
- **Item IDs · Required**: Item ids, separated by commas (at most 50). Shows when **Items** is **Several items**.
- **Item · Required**: The item's id, or its link. For a new subitem: the parent item. Shows when **Items** isn’t **Several items** and **Create As** isn’t **Item**.
- **Action · Optional**: Archive the item (it can be restored from the archive for 30 days) or delete it (it goes to the trash). Options: Archive, Delete. Default: Archive.

### Clear Column Values

- **Board · Required**: The board the item is on (or, for Create, the board to add it to). Shows when **Create As** isn’t **Subitem**.
- **Item IDs · Required**: The items to clear, separated by commas (at most 50).
- **Columns · Required**: The column ids to empty, separated by commas.

### Create

- **Create As · Optional**: A new item on a board, or a subitem under an existing item. Options: Item, Subitem. Default: Item.
- **Board · Required**: The board the item is on (or, for Create, the board to add it to). Shows when **Create As** isn’t **Subitem**.
- **Item · Required**: The item's id, or its link. For a new subitem: the parent item. Shows when **Items** isn’t **Several items** and **Create As** isn’t **Item**.
- **Name · Required**: The new item's name.
- **Group · Optional**: The group to add the item to. Empty: the board's top group. Shows when **Create As** is **Item**.
- **Column Values · Optional**: Column id → value in monday's format, such as {"status": {"label": "Done"}, "date4": {"date": "2026-11-07"}, "text": "Hello", "numbers": "3"}.
- **Create Missing Labels · Optional**: Add a status or dropdown label that does not exist yet instead of failing (needs permission to change the board's structure). Off by default.

### Duplicate

- **Board · Required**: The board the item is on (or, for Create, the board to add it to). Shows when **Create As** isn’t **Subitem**.
- **Item · Required**: The item's id, or its link. For a new subitem: the parent item. Shows when **Items** isn’t **Several items** and **Create As** isn’t **Item**.
- **With Updates · Optional**: Copy the item's updates too. Off by default.

### Get

- **Item · Required**: The item's id, or its link. For a new subitem: the parent item. Shows when **Items** isn’t **Several items** and **Create As** isn’t **Item**.
- **Include Subitems · Optional**: Return each item's subitems with their column values. Off by default.
- **Include Updates · Optional**: Return the item's latest 25 updates. Off by default.

### Get by Column Value

- **Board · Required**: The board the item is on (or, for Create, the board to add it to). Shows when **Create As** isn’t **Subitem**.
- **Column · Required**: The column to read or match.
- **Value · Required**: The value to match, as monday shows it (a status label, a date 2026-11-07, an email). Several: separated by commas. Any of them matches.
- **Include Subitems · Optional**: Return each item's subitems with their column values. Off by default.
- **Return All · Optional**: Read every item, page by page (at most 2000; past that the step fails rather than stop early). Off by default.
- **Limit · Optional**: How many items to return (1–2000). Default: 50. Shows when **Return All** is off.

### Get Column Value

- **Board · Required**: The board the item is on (or, for Create, the board to add it to). Shows when **Create As** isn’t **Subitem**.
- **Item · Required**: The item's id, or its link. For a new subitem: the parent item. Shows when **Items** isn’t **Several items** and **Create As** isn’t **Item**.
- **Column · Required**: The column to read or match.

### Get Many

- **Board · Required**: The board the item is on (or, for Create, the board to add it to). Shows when **Create As** isn’t **Subitem**.
- **Groups · Optional**: Only items in these groups (group ids, separated by commas). Empty: every group.
- **Filter · Optional**: Only items that match, as monday's item rules, such as [{"column_id": "status", "compare_value": ["Done"], "operator": "any_of"}].
- **Match · Optional**: Whether an item must match every rule or any of them. Options: All rules, Any rule. Default: All rules.
- **Sort By · Optional**: Order the items by this column. Empty: the board's order.
- **Direction · Optional**: Sort order. Options: Ascending, Descending. Default: Ascending.
- **Include Subitems · Optional**: Return each item's subitems with their column values. Off by default.
- **Return All · Optional**: Read every item, page by page (at most 2000; past that the step fails rather than stop early). Off by default.
- **Limit · Optional**: How many items to return (1–2000). Default: 50. Shows when **Return All** is off.

### List Subscribers

- **Item · Required**: The item's id, or its link. For a new subitem: the parent item. Shows when **Items** isn’t **Several items** and **Create As** isn’t **Item**.

### Move

- **Board · Required**: The board the item is on (or, for Create, the board to add it to). Shows when **Create As** isn’t **Subitem**.
- **Item · Required**: The item's id, or its link. For a new subitem: the parent item. Shows when **Items** isn’t **Several items** and **Create As** isn’t **Item**.
- **Move To · Optional**: Another group on the same board, or another board. Options: A group on this board, Another board. Default: A group on this board.
- **Target Board · Required**: The board to move the item to. Shows when **Move To** is **Another board**.
- **Group · Required**: The group to move the item to. Shows when **Move To** is **A group on this board**.
- **Target Group · Required**: The group on that board. Shows when **Move To** is **Another board**.
- **Column Mapping · Optional**: Which column of the target board takes each column's value: {"status": "status_1", "date4": "date"}. Empty: monday matches columns by title and type. Shows when **Move To** is **Another board**.

### Search

- **Search Text · Required**: What to look for in item names and content, across the account.
- **Results · Optional**: How many of the best matches to return (1–20; monday's search has no further pages). Default: 10.
- **Boards · Optional**: Only items on these boards (ids, separated by commas).
- **Workspaces · Optional**: Only items in these workspaces (ids, separated by commas).
- **Include Live Data · Optional**: Also read each match as it is now (state, board, group): the search index can lag a little behind. Off by default.

### Update

- **Board · Required**: The board the item is on (or, for Create, the board to add it to). Shows when **Create As** isn’t **Subitem**.
- **Item · Required**: The item's id, or its link. For a new subitem: the parent item. Shows when **Items** isn’t **Several items** and **Create As** isn’t **Item**.
- **New Name · Optional**: The item's new name. Empty: keep it.
- **Column Values · Optional**: Column id → value in monday's format, such as {"status": {"label": "Done"}, "date4": {"date": "2026-11-07"}, "text": "Hello", "numbers": "3"}.
- **Create Missing Labels · Optional**: Add a status or dropdown label that does not exist yet instead of failing (needs permission to change the board's structure). Off by default.

### monday.com › Board

### Aggregate Item Data

- **Board · Required**: The board to read or change.
- **Calculation · Optional**: What to calculate over the board's items, on monday's side (the items are never read). Options: Count items, Count values, Count unique values, Sum, Average, Median, Minimum, Maximum. Default: Count items.
- **Column · Optional**: The column to calculate over (a number column for sums and averages). Shows when **Calculation** is **Count values**, **Count unique values**, **Sum**, **Average**, **Median**, **Minimum** or **Maximum**.
- **Group By · Optional**: Calculate per value of this column (a status, a person, a date …), like a pivot table. Empty: one result for the board.
- **Date Grouping · Optional**: For a date column: group by day, week, month, quarter or year. Options: Exact date, Day, Week, Month, Quarter, Year. Default: Exact date.
- **Filter · Optional**: Only items that match, as monday's item rules, such as [{"column_id": "status", "compare_value": ["Done"], "operator": "any_of"}].
- **Match · Optional**: Whether an item must match every rule or any of them. Options: All rules, Any rule. Default: All rules.
- **Most Groups · Optional**: With Group By: how many groups to return at most. Default: 50.

### Archive or Delete

- **Board · Required**: The board to read or change.
- **Action · Optional**: Archive the board (it can be restored from the archive for 30 days) or delete it (it goes to the trash). Options: Archive, Delete. Default: Archive.

### Create

- **Board Name · Required**: The new board's name.
- **Board Kind · Optional**: Who can see the board: everyone in the account, only its members, or members and guests. Options: Main (public), Private, Shareable. Default: Main (public).
- **Description · Optional**: The board's description.
- **Workspace · Optional**: The workspace the board goes in. Empty: the main workspace (or, for a copy, the original's).
- **Folder ID · Optional**: The id of a folder in that workspace to put the board in.
- **Template ID · Optional**: Create the board from this template or board (its id).
- **Owners · Optional**: User ids to make owners of the board, separated by commas. Empty: you.
- **Subscribers · Optional**: User ids to subscribe to the board, separated by commas.

### Duplicate

- **Board · Required**: The board to read or change.
- **Duplicate Type · Optional**: What the copy takes from the original. Options: Structure only, Structure and items, Structure, items and updates. Default: Structure only.
- **New Board Name · Optional**: The copy's name. Empty: monday names it after the original.
- **Workspace · Optional**: The workspace the board goes in. Empty: the main workspace (or, for a copy, the original's).
- **Folder ID · Optional**: The id of a folder in that workspace to put the board in.
- **Keep Subscribers · Optional**: Give the copy the original's subscribers. Off by default.

### Get and List Subscribers

- **Board · Required**: The board to read or change.

### Get Many

- **State · Optional**: Which boards to list. Options: Active, Archived, Deleted, All. Default: Active.
- **Board Kind · Optional**: List only boards of this kind. Options: Any, Main (public), Private, Shareable. Default: Any.
- **Workspaces · Optional**: Only boards in these workspaces (ids, separated by commas).
- **Order · Optional**: Most recently used or most recently created first. Options: Last used, Created. Default: Last used.
- **Return All · Optional**: Read every result, page by page (at most 2000; past that the step fails rather than stop early). Off by default.
- **Limit · Optional**: How many results to return (1–2000). Default: 50. Shows when **Return All** is off.

### List Activity Logs

- **Board · Required**: The board to read or change.
- **From · Optional**: Only events at or after this time (ISO 8601, such as 2026-11-01T00:00:00Z).
- **To · Optional**: Only events before this time (ISO 8601).
- **Users · Optional**: Only events by these users (ids, separated by commas).
- **Columns · Optional**: Only events on these columns (column ids, separated by commas).
- **Groups · Optional**: Only events in these groups (group ids, separated by commas).
- **Items · Optional**: Only events on these items (ids, separated by commas).
- **Return All · Optional**: Read every result, page by page (at most 2000; past that the step fails rather than stop early). Off by default.
- **Limit · Optional**: How many results to return (1–2000). Default: 50. Shows when **Return All** is off.

### Search

- **Search Text · Required**: What to look for in board names and content, across the account.
- **Results · Optional**: How many of the best matches to return (1–20; monday's search has no further pages). Default: 10.
- **Workspaces · Optional**: Only boards in these workspaces (ids, separated by commas).
- **Include Live Data · Optional**: Also read each match as it is now (state, board, group): the search index can lag a little behind. Off by default.

### Update

- **Board · Required**: The board to read or change.
- **Change · Optional**: What to change. Options: Name, Description. Default: Name.
- **New Value · Required**: The board's new name or description.

### Update Subscribers

- **Board · Required**: The board to read or change.
- **Action · Optional**: Add people and teams to the board, or take them off it. Options: Add, Remove. Default: Add.
- **Users · Optional**: User ids, separated by commas.
- **Teams · Optional**: Team ids, separated by commas.
- **Add As · Optional**: Subscribers follow the board; owners can also change its structure and settings. Options: Subscriber, Owner. Default: Subscriber. Shows when **Action** is **Add**.

### monday.com › Group

### Archive or Delete

- **Board · Required**: The board the group is on.
- **Group · Required**: The group to change.
- **Action · Optional**: Archive the group and all its items (it can be restored from the archive for 30 days) or delete it (it goes to the trash). Options: Archive, Delete. Default: Archive.

### Create

- **Board · Required**: The board the group is on.
- **Group Name · Required**: The new group's name (at most 255 characters).
- **Color · Optional**: The group's colour. Options: Leave as it is to Brown (19 options).
- **Position · Optional**: Where the group goes: at the top of the board, or next to another group. Options: Top of the board, Before a group, After a group. Default: Top of the board.
- **Relative To Group · Required**: The group to place it before or after. Shows when **Position** is **Before a group** or **After a group**.

### Duplicate

- **Board · Required**: The board the group is on.
- **Group · Required**: The group to change.
- **New Title · Optional**: The copy's name. Empty: monday names it after the original.
- **Add To Top · Optional**: Put the copy at the top of the board instead of under the original. Off by default.

### Get Many

- **Board · Required**: The board the group is on.
- **Groups · Optional**: Only these groups (group ids, separated by commas). Empty: every group.

### Update

- **Board · Required**: The board the group is on.
- **Group · Required**: The group to change.
- **New Title · Optional**: The group's new name. Empty: keep it.
- **Color · Optional**: The group's colour. Options: Leave as it is to Brown (19 options).
- **Move · Optional**: Move the group next to another group, or leave it where it is. Options: Leave where it is, Before a group, After a group. Default: Leave where it is.
- **Relative To Group · Required**: The group to move it before or after. Shows when **Move** is **Before a group** or **After a group**.

### monday.com › Column

### Add Label

- **Board · Required**: The board the column is on.
- **Column · Required**: The column to change. For labels: a status or dropdown column.
- **Label Name · Required**: The new label's name (at most 30 characters).
- **Color · Optional**: A status label's colour (dropdown labels have none). Options: Leave as it is (a new label: orange) to teal (41 options).
- **Counts as Done · Optional**: For a status label: whether items with it count as done. Options: Leave as it is, Yes, No.

### Create

- **Board · Required**: The board the column is on.
- **Title · Required**: The new column's title.
- **Type · Required**: The kind of column. Options: Status to Assignees (36 options). Default: Text.
- **Description · Optional**: The column's description, shown on its header.
- **Settings · Optional**: The column's settings for its type, such as a status column's labels: {"labels": {"0": "To do", "1": "Done"}}.
- **Column ID · Optional**: Your own id for the column: 1–20 lowercase letters and _, unique on the board. Empty: monday makes one.
- **After Column · Optional**: Put the new column after this one. Empty: at the end.

### Create or Get Tag

- **Tag Name · Required**: The tag to find, or create when it does not exist yet: for writing into a tags column.
- **Private Board · Optional**: For a private or shareable board: its id (those boards keep their own tags). Empty: the account's public tags.

### Delete

- **Board · Required**: The board the column is on.
- **Column · Required**: The column to change. For labels: a status or dropdown column.

### Get Many

- **Board · Required**: The board the column is on.

### Update

- **Board · Required**: The board the column is on.
- **Column · Required**: The column to change. For labels: a status or dropdown column.
- **New Title · Optional**: The column's new title. Empty: keep it.
- **New Description · Optional**: The column's new description. Empty: keep it.
- **Width · Optional**: The column's width in pixels. Empty: keep it.
- **Settings · Optional**: New settings for the column's type (they replace the ones they name). Empty: keep them. Labels are changed with Add Label and Update Label.

### Update Label

- **Board · Required**: The board the column is on.
- **Column · Required**: The column to change. For labels: a status or dropdown column.
- **Label · Required**: The label to change: its name as it reads now, or its id.
- **New Name · Optional**: The label's new name. Empty: keep it.
- **Color · Optional**: A status label's colour (dropdown labels have none). Options: Leave as it is (a new label: orange) to teal (41 options).
- **Counts as Done · Optional**: For a status label: whether items with it count as done. Options: Leave as it is, Yes, No.
- **Hidden · Optional**: Hide the label from the label picker (items keep it), or show it again. Options: Leave as it is, Hide, Show.

### monday.com › Update

### Add File

- **Update · Required**: The update's (or reply's) id.
- **File · Required**: Upload a file, or switch to an expression to use one from an earlier step (such as {{steps.download.result}}). At most 500 MB.

### Create

- **Item · Required**: The item (its id or link) the update is on. Shows when **Updates Of** isn’t **The whole account**.
- **Body · Required**: The update's text. HTML formatting (\<b>, \<a href>, \<p>) is kept.
- **Reply To · Optional**: To reply in a thread: the id of the update to answer. Empty: a new update.

### Delete

- **Update · Required**: The update's (or reply's) id.

### Get Many

- **Updates Of · Optional**: One item's updates, or the latest across the account. Options: An item, The whole account. Default: An item.
- **Item · Required**: The item (its id or link) the update is on. Shows when **Updates Of** isn’t **The whole account**.
- **Include Replies · Optional**: Return each update's replies. Off by default.
- **Return All · Optional**: Read every update, page by page (at most 2000; past that the step fails rather than stop early). Off by default.
- **Limit · Optional**: How many updates to return (1–2000). Default: 25. Shows when **Return All** is off.

### Search

- **Search Text · Required**: What to look for in update names and content, across the account.
- **Results · Optional**: How many of the best matches to return (1–20; monday's search has no further pages). Default: 10.
- **Boards · Optional**: Only updates on these boards (ids, separated by commas).
- **Authors · Optional**: Only updates by these users (ids, separated by commas).
- **Include Live Data · Optional**: Also read each match as it is now (state, board, group): the search index can lag a little behind. Off by default.

### monday.com › User

### Get Many

- **Name · Optional**: Only people whose name matches this (a fuzzy match).
- **Emails · Optional**: Only these people (emails, separated by commas).
- **Return All · Optional**: Read every user, page by page (at most 2000; past that the step fails rather than stop early). Off by default.
- **Limit · Optional**: How many users to return (1–2000). Default: 50. Shows when **Return All** is off.

Source: https://docs.gorunner.io/apps/monday