Monday.com

Integrate your Workflow with 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)

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.

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

Note: Monday.com column values follow a specific JSON format that varies by column type. Refer to the Monday.com API documentation for the correct structure for each column type (status, date, person, etc.).