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
- In the sidebar, open Connections and press Add connection.
- Type
monday.comand choose monday.com. - Choose Sign in with monday.com.
- 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.
- Create an app in monday.com’s developer settings (monday.com’s guide).
- In GoRunner, copy the Redirect address to add in monday.com’s developer settings, and add it to the app.
- Paste the Client ID and Client secret, then press Save and sign in.
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 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 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.
- ItemArchive or Delete · Clear Column Values · Create · Duplicate · Get · Get by Column Value · Get Column Value · Get Many · List Subscribers · Move · Search · Update
- BoardAggregate Item Data · Archive or Delete · Create · Duplicate · Get · Get Many · List Activity Logs · List Subscribers · Search · Update · Update Subscribers
- GroupArchive or Delete · Create · Duplicate · Get Many · Update
- ColumnAdd Label · Create · Create or Get Tag · Delete · Get Many · Update · Update Label
- UpdateAdd File · Create · Delete · Get Many · Search
- UserGet Many
Later steps read a step’s output by its name: see 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.
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 returns every field.
It can change something outside the run (writes_external). See How versions and side effects work.
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.