> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://support.atomicwork.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://support.atomicwork.com/_mcp/server.

# Monday.com

## Monday.com: Overview and setup

Manage boards, items, and workflows with the Monday.com integration.

Connect Monday.com to Atomicwork to manage boards, items, and workflows through the Monday.com GraphQL API.

### Usecases

By connecting Monday.com, your teams can:

* **Manage boards and items:** Create, update, and manage Monday.com boards and items from Atomicwork workflows — for example, creating a project board when a new initiative is approved.
* **Automate item creation:** Generate Monday.com items from workflow triggers, such as creating a task item when an onboarding request is submitted.
* **Sync workflows across tools:** Keep Monday.com project data in sync with Atomicwork service management by automating updates across both platforms.
* **Custom operations:** Execute any Monday.com GraphQL query or mutation for workflows beyond standard use cases.

### Permissions

To connect Monday.com to Atomicwork, you need:

* **Org admin access** in Atomicwork
* **Admin access** to your Monday.com account

The integration authenticates via OAuth 2.0. During authorization, Atomicwork's Monday.com app requests the following scopes:

| **OAuth Scope**    | **Purpose**                                                                                       |
| ------------------ | ------------------------------------------------------------------------------------------------- |
| **`boards:read`**  | Read access to boards. Required for retrieving board information and supporting workflow lookups. |
| **`boards:write`** | Write access to boards. Required for creating and updating boards from workflows.                 |
| **`items:read`**   | Read access to items. Required for retrieving item data and supporting workflow lookups.          |
| **`items:write`**  | Write access to items. Required for creating and updating items from workflows.                   |

### Setup

* Go to **Settings > Enterprise integrations > App store > Monday.com**.
* Click **Connect** to initiate the OAuth flow.
* Sign in with your Monday.com account and authorize the integration.
* Once authorized, the integration is active.

### Supported workflow actions

| **Action**   | **Description**                                                                                                  |
| ------------ | ---------------------------------------------------------------------------------------------------------------- |
| **Call API** | Make a generic GraphQL API call to Monday.com. Use this for all board, item, column, group, and user operations. |

> \[!NOTE]
> **Note:** Monday.com currently supports the Call API action, which gives you access to the full Monday.com GraphQL API. Refer to the [Monday.com API documentation](https://developer.monday.com/api-reference) for available queries and mutations.

### Troubleshoot common issues

| **Error**                            | **Cause**                                                                           | **Resolution**                                                                                        |
| ------------------------------------ | ----------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |
| **Authentication failure (401/403)** | The access token is invalid or the OAuth application lacks required permissions.    | Re-authenticate the integration from **Settings > Enterprise integrations > App store > Monday.com**. |
| **GraphQL errors**                   | The API query or mutation has invalid syntax or references fields that don't exist. | Verify the query against the Monday.com API documentation and correct the syntax.                     |

---