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