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 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.