Skip to main content

Monday.com: Overview and setup

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

R
Written by Riya Sebastian

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

Did this answer your question?