# Monday.com The Monday.com Integration step allows you to connect your AirOps workflows with Monday.com boards and workspaces. This native integration provides comprehensive board, group, item, subitem, and update management capabilities directly from your workflows. ## Overview Monday.com is a work operating system that enables teams to build custom workflows and manage projects visually. By connecting Monday.com to AirOps, you can automate item creation, update board content, track project progress, and integrate AI-powered content into your boards. ## Authentication Before using the Monday.com integration in your workflows, you must first connect your Monday.com account in the AirOps Settings: 1. Navigate to **Settings > Integrations** 2. Find the Monday.com section and click "Configure" 3. Enter your **API Token** — found in your Monday.com account under **Profile Picture > Administration > Connections > Personal API Token** (or via your profile avatar at the bottom-left under **Developers > My Access Tokens**) {% hint style="info" %} Your Monday.com API token grants access to all boards and workspaces your account can see. Use a token from an account with the appropriate permissions for the boards your workflows will interact with. {% endhint %} ## Available Actions ### Board Management * **Create Board** -- add a new board to a workspace * **List Boards** -- fetch boards from all workspaces or a specific workspace ### Group Management * **Create Group** -- add a new group to a board * **List Groups** -- fetch all groups in a board ### Item Management * **Create Item** -- add a new item to a board or group * **Get Item** -- retrieve a single item by ID * **List Items** -- fetch items from a board or group with cursor-based pagination * **Update Item** -- modify column values of an existing item * **Delete Item** -- permanently remove an item * **Move Item to Group** -- move an item to a different group within a board ### Subitem Management * **Create Subitem** -- add a subitem under an existing item ### Updates * **Create Update** -- add an update (comment) to an item * **Get Updates** -- retrieve updates posted on an item ### Workspace Management * **List Workspaces** -- fetch all workspaces in the account ## Action Parameters ### Create Board 1. **Board Name** (required) -- the name of the new board (e.g. `Content Pipeline Q1`) 2. **Visibility** (required) -- who can access the board: `public`, `private`, or `share` 3. **Workspace ID** -- the numeric ID of the workspace to create the board in. Leave blank to use the default workspace 4. **Description** -- an optional description for the board ### List Boards 1. **Workspace ID** -- filter boards by workspace ID. Leave blank to return boards from all workspaces 2. **Limit** -- maximum number of boards to return (default: `25`, max: `100`) 3. **Page** -- page number for pagination (default: `1`) ### Create Group 1. **Board** (required) -- select the Monday.com board 2. **Group Name** (required) -- the name of the new group (max 255 characters) ### List Groups 1. **Board** (required) -- select the Monday.com board ### Create Item 1. **Board** (required) -- select the Monday.com board 2. **Item Name** (required) -- the name of the new item 3. **Group** -- select a group within the board to add the item to 4. **Column Values** -- a JSON object mapping column IDs to their values (e.g. `{"status": {"label": "Done"}, "date4": {"date": "2024-12-31"}}`) ### Get Item 1. **Item ID** (required) -- the numeric ID of the item to retrieve ### List Items 1. **Board** (required) -- select the Monday.com board 2. **Group** -- select a group within the board to filter items 3. **Limit** -- maximum number of items to return (default: `50`, max: `500`) 4. **Cursor** -- pagination cursor from a previous List Items result. When provided, the board and group selections are ignored ### Update Item 1. **Board** (required) -- select the Monday.com board 2. **Item ID** (required) -- the numeric ID of the item to update 3. **Column Values** (required) -- a JSON object mapping column IDs to their new values (e.g. `{"status": {"label": "In Progress"}, "text": "Updated content"}`) ### Delete Item 1. **Item ID** (required) -- the numeric ID of the item to delete ### Move Item to Group 1. **Item ID** (required) -- the numeric ID of the item to move 2. **Board** (required) -- select the board containing the item (used to populate the group options) 3. **Group** (required) -- select the destination group within the board ### Create Subitem 1. **Parent Item ID** (required) -- the numeric ID of the parent item 2. **Item Name** (required) -- the name of the subitem 3. **Column Values** -- a JSON object mapping column IDs to their values ### Create Update 1. **Item ID** (required) -- the numeric ID of the item to post the update on 2. **Body** (required) -- the text content of the update ### Get Updates 1. **Item ID** (required) -- the numeric ID of the item 2. **Limit** -- maximum number of updates to return (default: `50`, max: `100`) 3. **Page** -- page number for pagination (default: `1`) ### List Workspaces 1. **Limit** -- maximum number of workspaces to return (default: `25`, max: `100`) 2. **Page** -- page number for pagination (default: `1`) ## Common Use Cases * Automatically creating board items from AI-generated content briefs * Updating item column values (status, dates, owners) based on workflow results * Posting AI-generated summaries or reports as updates on existing items * Moving items across groups as they progress through a content pipeline * Creating subitems to break down tasks into smaller, trackable steps * Building editorial calendars by creating groups and items for each content piece * Fetching board items to enrich, rewrite, or analyze existing content at scale {% hint style="info" %} Note: Monday.com column values follow a specific JSON format that varies by column type. Refer to the [Monday.com API documentation](https://developer.monday.com/api-reference/docs/column-types-reference) for the correct structure for each column type (status, date, person, etc.). {% endhint %} --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.airops.com/context/overview/project-management/monday.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.