- Documentation
- Integrations
- Apps
- monday.com integration
monday.com integration
Manage monday.com boards, items, subitems, updates and files for your clients, and react instantly when something changes on a board.
What it does
The monday.com integration lets your agency run a client's monday.com boards from TaskJuice on behalf of your clients. Connect a client's monday.com account once, then create, find, update, move, duplicate, archive and delete items and subitems; set column values; post updates and notifications; upload and download files; and manage boards, groups, columns and board subscribers. Board, group, column, user, team and workspace fields render as dropdowns of live options from the connected account.
Eleven instant triggers fire the moment an item, column value, update or column changes on a board you pick. Seven polling triggers cover new boards, users, board subscribers, team members, items, item changes and items reaching a column value.
Before you start
- Plan. monday.com's API limits, such as daily calls and query complexity, depend on the connected account's plan. Instant triggers use the account's monthly integration actions, whose allowance also depends on the plan. A monday.com developer account works for building and testing workflows before you connect a client's account.
- Your own monday.com app. Your agency connects through its own monday.com app, so the consent screen your clients see carries your app's name. You create it once and reuse it for every client.
Connect a monday.com account
Create a monday.com app
In monday.com, click your profile picture, choose Developers to open the Developer Center, and click Create app.
Add the OAuth scopes
Open the app's OAuth section and add these scopes:
me:read,account:read,boards:read,boards:write,updates:read,updates:write,users:read,teams:read,workspaces:read,tags:read,assets:read,notifications:writeandwebhooks:write. The instant triggers needwebhooks:writeto register themselves on a board. Addai:consumetoo if you plan to use Run AI Prompt.Add the TaskJuice redirect URL
In TaskJuice, open the monday.com OAuth client settings, either from the monday.com node in the workflow editor or under Apps → Monday.com. Copy the redirect URL shown there and add it to the app's Redirect URLs in the Developer Center. It must match exactly.
Paste the Client ID and Client Secret into TaskJuice
Copy the Client ID and Client Secret from the app's basic information in the Developer Center, paste them into the TaskJuice OAuth client settings, tick the same scopes, and save.
Connect the account
From a monday.com node in the workflow editor, choose Connect, sign in to the monday.com account that should authorize the connection, and approve the consent screen.
monday.com access tokens do not expire. A connection stays valid until your app is uninstalled from the client's monday.com account, which is also how the client revokes access. Deleting the connection in TaskJuice stops TaskJuice from using it.
Triggers
Instant triggers
Each instant trigger asks you to pick a board. When you publish the workflow, TaskJuice registers a monday.com webhook on that board for you and answers monday.com's verification challenge. There is nothing to paste into monday.com. Unpublishing does not remove the webhook right away; see Known limitations. The Board field takes a concrete board, not an expression, because monday.com webhooks are registered per board.
These triggers use monday.com's webhook integration, so every delivery consumes the connected account's monthly integration actions. If a delivery fails, monday.com retries it once a minute for up to 30 minutes, so a retry can occasionally run a workflow twice for one event. If a duplicate run would matter, deduplicate downstream on event.triggerUuid, which stays the same across retries.
- Item Created (Instant) fires when an item is created on the board. Creating a subitem does not fire it.
- Column Value Changed (Instant) fires when any column value changes on an item, with
event.valueandevent.previousValue(nullwhen the column was empty). - Item Name Changed (Instant) fires when an item is renamed, with the old and new names.
- Item Moved to Group (Instant) fires when an item moves from one group to another, with the source and destination groups.
- Item Archived (Instant) fires when an item is archived. Its subitems are archived with it and send no separate event.
- Item Deleted (Instant) fires when an item is moved to the trash. Its subitems send no separate event.
- Item Restored (Instant) fires when an archived or deleted item is restored.
- New Update (Instant) fires when an update (comment) or a reply is posted on an item, with its HTML and plain-text bodies.
- Update Edited (Instant) fires when an update is edited.
- Update Deleted (Instant) fires when an update is deleted.
- Column Created (Instant) fires when a column is added to the board.
Every delivery arrives under event, with event.boardId, event.pulseId (the item id), event.userId, event.triggerTime and event.triggerUuid. The triggerUuid stays the same across monday.com's retries of one delivery.
React to one specific column
Column Value Changed (Instant) fires for every column on the board. To act on one column only, filter on the column id: add a Switch node after the trigger with the selector $trigger.event.columnId, add one case whose value is the column's id (for example status), and set no-match behavior to Skip. Changes to any other column then end the run without doing anything. Run List Columns once to find the ids on a board. The shape of event.value depends on the column type: a status column sends { "label": { "index", "text", "style", "is_done" }, "post_id" }, a text column sends { "value" } and a date column sends { "date", "time" }.
Polling triggers
Polling triggers check monday.com on an interval. The default Poll Interval is 300 seconds (5 minutes), adjustable from 60 seconds to 24 hours under the trigger's advanced settings. Each cycle fires once with every new record in an items array, up to the per-cycle maximum (100 by default, 500 at most; New Item With Column Value, New Board Subscriber and New Team Member default to 500). Add a Loop node to handle each record on its own.
On the first cycle after you publish, the records already there are recorded as seen and do not fire. Only records created or changed after publishing do.
- New Board watches the account for newly created boards.
- New User watches the account for newly added users, including invited users who have not accepted yet. Deactivated users are not included.
- New Board Subscriber watches one board for users newly subscribed to it.
- New Team Member watches one team for users newly added to it.
- New Item watches one board for newly created items. Each item fires once.
- Item Updated watches one board for items whose name, state or column values changed. An item fires again each time it changes.
- New Item With Column Value watches one board for items whose chosen column equals a value, such as Status = Ready. Each item fires once, the first time it is seen matching. Each check reads up to 500 matching items.
Actions
Items
- Create Item creates an item on a board, optionally in a chosen group, with starting column values and a position before or after another item.
- Get Items by ID fetches up to 100 items by id, with their board, group, parent item, column values and files.
- Get Items by Board lists a board's items one page at a time, with an optional filter and sort. Pass the returned
cursorto fetch the next page. - List Group Items lists the items in one group, one page at a time.
- Find Items by Column Value finds items whose column matches one of the values you give, one page at a time.
- Update Item Name renames an item.
- Move Item to Group moves an item to another group on the same board.
- Move Item to Board moves an item and its subitems to a group on another board, optionally mapping source columns to target columns. When you set a mapping, map every column; formula columns cannot be mapped.
- Duplicate Item duplicates an item on its board, optionally with its updates.
- Archive Item archives an item and its subitems. Archived items can be restored from the board archive.
- Delete Item deletes an item. monday.com moves it to its trash, where it can be restored in monday.com for a limited time. TaskJuice cannot restore it.
- List Item Subscribers lists the users subscribed to an item.
Paged list actions return up to 500 items per page, the most monday.com allows.
Subitems
- Create Subitem creates a subitem under an item, optionally with starting column values.
- Get Subitems lists an item's subitems with their column values, plus the id of the subitems board they live on.
- Update Subitem Column Values updates one or more column values on a subitem. It needs the subitems board id from Get Subitems or Create Subitem, and the subitems board's column ids, which differ from the parent board's.
Column values
- Update Item Column Values sets several column values on an item in one step.
- Change Simple Column Value sets one column from plain text, such as
Donefor a status,2026-10-01for a date or42for a number. An empty value clears text and number columns. - Change Column Value sets one column from a structured value, for columns such as people, timeline, location or connect boards. Send
{}to clear the column. - Create or Get Tag creates a tag by name, or returns the existing tag with that name.
Updates and notifications
- Create Update posts an update (comment) on an item, or a reply to an existing update.
- Edit Update replaces the text of an update or reply.
- Delete Update deletes an update or reply permanently.
- List Item Updates lists an item's updates, newest first, with their replies.
- List Board Updates lists the updates across a board, newest first, with their replies.
- Create Notification sends a monday.com notification to a user about an item, board or update.
Files
- Add File to Column uploads a file from an earlier step into an item's file column, up to 500 MB.
- Add File to Update uploads a file onto an update or reply, up to 500 MB.
- Get Assets fetches file details by asset id, including a public download URL that stays valid for one hour.
- Download Asset downloads a file from that one-hour URL so later steps can use it. Run it in the same run as Get Assets.
Boards
- Get Boards lists the boards the connection can access, filtered by workspace, state and board kind.
- Get Board gets one board with its workspace, owners, subscribers, groups, columns and item count.
- Create Board creates a board in a workspace and folder, optionally from a template or an existing board.
- Update Board changes one board attribute: its name, description, communication value or item nickname.
- Duplicate Board copies a board's structure, optionally with its items and their updates, into the same or another workspace.
- Archive Board archives a board. It keeps its data and can be restored.
- List Board Subscribers lists a board's subscribers and owners.
- Add Users to Board adds users to a board as subscribers or owners.
- Remove Users from Board removes users from a board's subscribers.
- Get Activity Logs reads a board's activity log, filtered by time window, users, columns, groups or items.
- Aggregate Board Data calculates counts, sums, averages and other summaries of a board's items, optionally grouped by a column and filtered.
Groups
- List Groups lists a board's groups with their color and position.
- Create Group creates an empty group, optionally before or after an existing group.
- Update Group changes one group attribute, such as its title, color or position.
- Duplicate Group duplicates a group and all of its items.
- Archive Group archives a group and keeps its items so it can be restored.
- Delete Group permanently deletes a group and every item in it.
Columns
- List Columns lists a board's columns with their ids, types and settings.
- Create Column creates a column of a chosen type, optionally with default settings and a position.
- Change Column Title renames a column.
- Change Column Metadata changes a column's title or description.
- Delete Column deletes a column and all of its values.
Users, teams and workspaces
- List Users lists the account's users, filtered by id, email, name, user kind or status.
- List Teams lists the account's teams with their members and owners.
- List Workspaces lists the account's workspaces, filtered by kind, state and membership.
- Get Current User gets the monday.com user the connection is signed in as.
- Get Account gets the connected account, including its plan, tier and products.
Advanced
- GraphQL Request runs any monday.com GraphQL query or mutation with a Variables object, for operations the other actions do not cover. Pass values through Variables rather than typing them into the query.
- Run AI Prompt sends a prompt to a monday.com-hosted AI model and returns the generated text. The connected account needs monday.com AI access, and your monday app needs the
ai:consumescope.
Format column values
Create Item, Create Subitem, Update Item Column Values and Update Subitem Column Values take Column Values as an object that maps each column id to its value:
{
"status": { "label": "Done" },
"date4": { "date": "2026-10-01" },
"text": "Kickoff call booked"
}Simple strings work for many columns, so { "status": "Done" } sets the same status as { "status": { "label": "Done" } }. Columns that hold structured data use monday.com's format for that column type:
{
"person": { "personsAndTeams": [{ "id": 4616627, "kind": "person" }] },
"timeline": { "from": "2026-10-01", "to": "2026-10-07" },
"connect_boards": { "item_ids": [12345] }
}Use column ids, not column titles. List Columns returns them.
By default, setting a status or dropdown label that does not exist on the board fails the step. Turn on Create Missing Labels to have monday.com create the label instead.
Known limitations
- Rate limits are shared per account. monday.com meters API calls by query complexity, with a per-minute budget per account shared by every workflow and every other integration using it. Large pages and wide reads cost more. When monday.com answers with a rate-limit error (HTTP 429), TaskJuice marks the step as retryable.
- Errors can arrive with a success status. monday.com reports many failures in an
errorsarray inside an HTTP 200 response. TaskJuice treats any response witherrorsas a failed step and shows monday.com's first message. - No separate subitem triggers. Subitem events are not available as their own triggers, and Item Created (Instant) does not fire for subitems. Archiving or deleting an item sends no events for its subitems.
- Delivery signatures are not verified. TaskJuice does not yet verify monday.com's delivery signature; each delivery is identified by the private URL registered for your workflow.
- Mirror, formula and connect boards columns return
display_value. For these columns monday.com returnsvalueasnull. Readdisplay_valueon the column instead. - Instant triggers cost integration actions. Each delivery counts toward the connected account's monthly integration actions, including deliveries from a webhook that is still registered after its trigger was unpublished or moved to another board (see below).
- Webhooks outlive an unpublish for a while. A board's webhook stays registered while any monday.com instant trigger on that connection is published, and for up to 90 days after the last one is unpublished, so republishing is instant. Then TaskJuice removes it. Changing a trigger's board, or unpublishing one of several monday.com triggers, leaves the earlier webhook in place until then. Deleting the connection removes its webhooks at once. Removal is best-effort for a webhook already deleted in monday.com, which TaskJuice cannot delete again.
- Webhooks removed in monday.com are not re-created. If the client removes a TaskJuice webhook from the board's Integrations > Webhooks, TaskJuice does not detect it and the trigger stops receiving events. Republishing does not bring it back. Ask clients to leave TaskJuice webhooks in place, and contact support if one was removed.
- Three instant triggers are not yet verified against a live delivery. The payload fields of Update Edited (Instant), Update Deleted (Instant) and Column Created (Instant) follow monday.com's documentation and may change once confirmed.
- New Item and Item Updated read the latest 50 items. Each cycle looks at the 50 most recently created (or updated) items on the board, so more than 50 new or changed items between two checks can be missed. Shorten the Poll Interval on very active boards, or use the matching instant trigger.
- Deletes are permanent. Delete Group, Delete Update and Delete Column cannot be undone from TaskJuice. Use the archive actions when you want a way back.
Related
- Connect an account
- Control flow for Switch and Loop nodes
- Data mapping