Skip to main content

Monday Integration - Setup Guide

Connect your Monday.com account to Goodweek to manage boards, items, groups, updates, workspaces, and team workflows directly from your AI workspace.

A
Written by Antoine Stempien

Connect your Monday.com account to Goodweek to manage boards, items, groups, updates, workspaces, and team workflows directly from your AI workspace.

ℹ️ Governance note

Goodweek will never exceed the access levels granted to the user within Monday.com, guaranteeing alignment with your organization's governance policies. Outcomes and available features may vary depending on each user's specific permissions and authenticated access.

📋 Prerequisites

Before any user can see and connect the Monday.com integration, your organization admin must first enable it from the Goodweek Admin Panel under the Integrations tab.

Admin Setup

⚠️ Workspace admin must install the Composio app first

Before users can connect Monday.com in Goodweek, a Monday.com Workspace Admin must pre-install the Composio app. Without this step, users will see an authorization error.

The admin must open the following URL while logged into Monday.com as a Workspace Admin:

https://auth.monday.com/oauth2/authorize?client_id=96b038435fc029e045f9ba800e66fefa&response_type=install

This installs Composio at the workspace level and allows individual users to then complete their own connection from Goodweek.

User Connection

  1. Once the Composio app has been installed by your Monday.com Workspace Admin, go to Goodweek → Integrations.

  2. Find Monday.com and click Connect.

  3. You will be redirected to Monday.com, where you will be asked to sign in and authorize access.

  4. Click Allow to grant access and return to Goodweek.

Important Notes

  • Each user must connect their own account individually after the Workspace Admin has installed Composio.

  • Goodweek can only access the boards, items, and data that your individual Monday.com account has permission to see. Board-level sharing restrictions apply.

  • Some tools (user deactivation, role updates, workspace management) require Monday.com Admin permissions.

  • You can revoke Goodweek's access at any time from Monday.com → My Profile → Developers → Authorized apps → Composio → Revoke.


Available Tools

Tool

Description

Type

Get Boards

Retrieves board metadata including ID, name, state, type, and hierarchy information.

Read

Create a Monday Board

Creates a new Monday.com board with optional template, workspace, and folder configuration.

Write

Update Board

Updates a specified attribute of an existing board on Monday.com.

Write

Archive Board

Archives a specified board, moving it from active views to the archive.

Write

Duplicate Board

Duplicates a Monday.com board with its structure and optionally its items and updates.

Read

Get Board Activity Logs

Retrieves activity logs from a specific board to track changes and user actions.

Read

Get Board Columns

Retrieves column metadata for a board including ID, title, type, and settings.

Read

Create Column

Creates a new column with a specified type and title on a board.

Write

List Groups

Lists all groups (sections) on a specified board.

Read

Create Group

Creates a new group on an existing board.

Write

Update Group

Updates a group's title, color, or other attributes on a board.

Write

Get Items Page

Retrieves items from a board or group with server-side filtering and full column values.

Read

Get Items by IDs

Retrieves specific items by their IDs including name, timestamps, and column values.

Read

List Items by Column Values

Searches for items on a board based on specific column values.

Read

Create Item

Creates a new item on a Monday.com board with optional group and column values.

Write

Create Item From Natural Language

Creates a new board item from a natural language description by matching it to the board's column schema.

Write

Update Item

Updates an existing item's column value on Monday.com.

Write

Archive Item

Archives an existing Monday.com item, moving it from active board views to the archive.

Write

Duplicate Item

Duplicates an item on a Monday.com board, optionally including its updates.

Read

Move Item to Group

Moves an item to a different group on the same Monday.com board.

Read

Move Item to Board

Moves a Monday.com item to a specified board and group.

Read

Change Simple Column Value

Changes a specific column's value for a Monday.com item using a simple string.

Read

Get Item Updates

Retrieves the update and conversation history for a specific item.

Read

Create Update

Creates a new update (comment) on an item or replies to an existing update.

Write

Edit Update

Modifies the text content of an existing update on an item.

Write

Create Notification

Sends a notification to a user about a board, item, or update.

Write

Get Workspaces

Lists workspaces with optional filtering, pagination, and ordering.

Read

Create a Monday Workspace

Creates a new Monday.com workspace.

Write

Get Teams

Retrieves all teams in the Monday.com account.

Read

Create Doc

Creates a new doc in Monday.com, optionally linked to a workspace or doc column.

Write

Retrieve Monday Docs

Retrieves Monday.com documents with filtering by workspace or board.

Read

List Users

Retrieves a paginated list of users from the Monday.com account.

Read

Get Current User

Retrieves the authenticated user's profile and permissions.

Read

Aggregate Board Data

Aggregates data across Monday.com boards using groupings and functions like COUNT or SUM.

Read

Get Account Info

Retrieves account metadata and settings for the authenticated Monday.com account.

Read

Get Tags

Retrieves all tags from the account, optionally filtered by specific IDs.

Read

Create Tag

Creates a new tag or returns an existing tag if it already exists.

Write

Upload Asset

Uploads a file to an update or file column in Monday.com.

Write

Delete Board

Permanently deletes a board from the Monday.com account. This action cannot be undone via the API.

⚠️ Destructive

Delete Item

Permanently deletes an existing Monday.com item. This action is irreversible via the API.

⚠️ Destructive

Delete Group

Permanently deletes an existing group and its items from a board.

⚠️ Destructive

Delete Update

Permanently deletes a specific update by its ID.

⚠️ Destructive

Delete Workspace

Permanently deletes a workspace by its ID. This action cannot be undone.

⚠️ Destructive

Use Cases

  • Create and update items from conversations. Add new Monday.com items to a board with column values and group assignments directly from a Goodweek conversation, without switching to Monday.com.

  • Search and review board data. Retrieve items from a board filtered by column value, review recent activity logs, or list groups and their items from Goodweek to get a quick overview of project status.

  • Post updates and notifications. Create item updates or send notifications to team members from Goodweek to keep collaborators informed without manually navigating Monday.com.

  • Manage boards and workspaces. Create new boards, archive finished projects, and structure workspaces directly from Goodweek when setting up or closing out projects.


Troubleshooting

Authorization error when trying to connect

The Composio app has not been installed by a Monday.com Workspace Admin. Follow the Admin Setup steps above — the admin must open the install URL before users can connect.

Connected but some boards are not visible

Monday.com boards respect their sharing settings. If a board is set to shareable or private, users must be explicitly added to see it. Ask the board owner to add you if needed.

Integration not visible in Goodweek

Make sure your organization admin has enabled the Monday.com integration from the Goodweek Admin Panel under the Integrations tab.

References

Did this answer your question?