Source: https://manu-tests-all-orgs.docs-staging.pageloop.ai/integrations/project-management/monday-com

# Monday.com

# 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

- Navigate to **Settings > 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 > 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. |

---