Docs / Workflows / Integrations / monday.com
monday.com
Read and manage boards, items, subitems, columns and updates in monday.com.
What you can do
Each monday.com integration’s page in OAIZ shows these uses, with its events and its read and write actions, under What you can do with monday.com.
- New requests
- Create an item on a board for each new request.
- Item updates
- Post an update on an item when its work moves on.
- Finished items
- Move finished items to another group or board.
Connection scope
Board IDs identify boards. Column and group IDs are specific to a board and differ from the titles shown in monday.com. Subitems live on a separate subitem board, so their column IDs can differ from the parent’s.
Connecting
Authorize OAIZ in monday.com using an account with access to the boards the workflows should use. Approve the requested app permissions and finish the return to OAIZ.
- Read permissions
- account:read, assets:read, boards:read, docs:read, me:read, tags:read, teams:read, updates:read, users:read, webhooks:read and workspaces:read.
- Write permissions
- boards:write, docs:write, notifications:write, teams:write, updates:write, users:write, webhooks:write and workspaces:write.
These are the permissions requested when connecting. Board and workspace access also depends on the connected user’s monday.com permissions.
Read actions
- Get Item
- Read one item’s column values and, optionally, its updates.
- Get Board
- Read a board’s column IDs, types, settings and group IDs.
- Get Items
- Read one filtered page of board items, optionally downloading attached files. The page contains up to 100 items.
- Get Boards
- List workspace boards with their IDs and names.
Write actions
- Create Item
- Create an item on a board, with a name, optional group and column values.
- Update Item
- Change an item’s name or column values using the board’s column IDs.
- Create Update
- Post a comment or note on an item’s update stream.
- Delete Item
- Delete an item from monday.com.
- Create Board
- Create a board in monday.com.
- Create Subitem
- Create an item beneath a parent item. Subitems use their own board’s column IDs.
- Delete Board
- Delete a board from monday.com.
- Move Item
- Move an item to a different group using the destination group ID.
- Archive Item
- Archive an item in monday.com.
- Upload File to Item
- Attach files to an item’s file column or update stream.
- Create Column
- Add a column to a board.
Events
Item creation, edits, movement, archive and deletion arrive as events. The connection also receives column creation and update-stream changes. Their board and item IDs connect those records to action inputs.