Monday.com integration

Work management: boards, items, columns, groups, updates, subitems

Help CentreConnectors

Overview

monday.com is a flexible work-management platform built around Boards (spreadsheets), Items (rows), and Columns (typed fields). The Automize monday connector covers board CRUD, item operations, column management, updates (comments), and user lookup via monday's GraphQL API.

  • Regions: monday.com is a single global platform – api.monday.com. No region selector.
  • Plans: Free, Basic, Standard, Pro, Enterprise – all expose the API. API rate limits and complexity budgets are uniform.

Setting up the connection

Auth type: Bearer Token.

  1. Sign in to monday → click your avatar → Developers → My Access Tokens.
  2. Generate a personal API token (or use a team token for org automation).
  3. Copy the token (no specific prefix).
  4. In Automize, open Settings → Connectors → monday → Add connection. Paste the token.

Find your credentials at https://my-account.monday.com/admin/api.


Rate limits

monday uses a complexity-based rate limit – each GraphQL query has a complexity score, and you have a budget per minute (~10,000 points/min for paid plans). The connector reads the X-RateLimit-Remaining header in responses and backs off. Heavy queries should request only the columns you actually need to keep complexity down.


Data model

monday's primitives:

    Account ─┬─ Workspaces
             └─ Boards ─┬─ Groups (sections – e.g. "This Week")
                        ├─ Columns (typed: text, status, person, date, numbers, etc.)
                        └─ Items (rows) ─┬─ Column Values (one per column)
                                          ├─ Sub-items
                                          └─ Updates (comments)

IDs are numeric (passed as strings or numbers, both accepted).

Available operations

18 operations available. Click any row to jump to its detail.

OperationCategoryWhat it does
Add file to columnGeneralAdd a file to a Monday.com file column.
Archive itemGeneralArchive a Monday.com item.
Change column valueGeneralChange a column value on a Monday.com item.
Create itemGeneralCreate a new item in a Monday.com board.
Create subitemGeneralCreate a subitem under a Monday.com parent item.
Create updateGeneralAdd an update/comment to a Monday.com item.
Create webhookGeneralCreate a Monday.com webhook.
Delete itemGeneralDelete a Monday.com item.
Duplicate itemGeneralDuplicate a Monday.com item.
Get boardGeneralGet Monday.com board details with columns and groups.
Get itemGeneralGet Monday.com item details by ID.
List boardsGeneralList all Monday.com boards.
List groupsGeneralList groups in a Monday.com board.
List itemsGeneralList items in a Monday.com board.
List subitemsGeneralList subitems of a Monday.com item.
List subscribersGeneralList subscribers for a Monday.com item.
Move item to groupGeneralMove a Monday.com item to a different group.
Update itemGeneralUpdate column values on a Monday.com item.

Operations

Add file to column

Add a file to a Monday.com file column.

No input parameters.


Archive item

Archive a Monday.com item.

ParameterRequiredTypeDescription
Query queryYestext
Variables variablesNotext

Tips

  • Soft-delete (archives). Restorable via UI.

Change column value

Change a column value on a Monday.com item.

ParameterRequiredTypeDescription
Query queryYestext
Variables variablesNotext

Create item

Create a new item in a Monday.com board.

ParameterRequiredTypeDescription
Board ID board_idYestext
Item name item_nameYestext
Group ID group_idNotext
Column values (JSON) column_valuesNotextarea

Tips

  • board_id + item_name.
  • column_values: JSON object mapping column_id → value. Each column type has its own value format (status: {label:'Done'} or {index:1}; date: {date:'2026-05-12'}; person: {personsAndTeams:[{id:123,kind:'person'}]}).

Create subitem

Create a subitem under a Monday.com parent item.

ParameterRequiredTypeDescription
Parent item ID parent_item_idYestext
Subitem name item_nameYestext
Column values (JSON) column_valuesNotextarea

Create update

Add an update/comment to a Monday.com item.

ParameterRequiredTypeDescription
Item ID item_idYestext
Update text bodyYestextarea

Tips

  • item_id + body. body supports rich text (HTML).

Create webhook

Create a Monday.com webhook.

ParameterRequiredTypeDescription
Query queryYestext
Variables variablesNotext

Delete item

Delete a Monday.com item.

ParameterRequiredTypeDescription
Item ID item_idYestext

Tips

  • Hard-delete. Irreversible after 30 days.

Duplicate item

Duplicate a Monday.com item.

ParameterRequiredTypeDescription
Query queryYestext
Variables variablesNotext

Get board

Get Monday.com board details with columns and groups.

ParameterRequiredTypeDescription
Board ID board_idYestext

Tips

  • Returns board + columns + groups + (paginated) items.
  • Use ids[board_id] form, even for a single board.

Get item

Get Monday.com item details by ID.

ParameterRequiredTypeDescription
Item ID item_idYestext

Tips

  • item_id. Returns column values, group, board, subitems, updates.

List boards

List all Monday.com boards.

No input parameters.

Tips

  • Filter by workspace_ids[]. ids[] to fetch specific boards.
  • Returns boards as a list. limit + page for pagination.

List groups

List groups in a Monday.com board.

ParameterRequiredTypeDescription
Board ID board_idYestext

Tips

  • Groups are board sections. Useful for filtering items by stage.

List items

List items in a Monday.com board.

ParameterRequiredTypeDescription
Board ID board_idYestext

Tips

  • Within a board. Use cursor pagination via items_page (modern API).
  • Returns items + column values. Request only column_values needed via column_ids[].

List subitems

List subitems of a Monday.com item.

ParameterRequiredTypeDescription
Parent item ID item_idYestext

List subscribers

List subscribers for a Monday.com item.

ParameterRequiredTypeDescription
Query queryYestext
Variables variablesNotext

Move item to group

Move a Monday.com item to a different group.

ParameterRequiredTypeDescription
Item ID item_idYestext
Target group ID group_idYestext

Update item

Update column values on a Monday.com item.

ParameterRequiredTypeDescription
Item ID item_idYestext
Board ID board_idYestext
Column values (JSON) column_valuesYestextarea

Tips

  • Use Change Column Value for single-column updates, or Change Multiple Column Values for bulk.
  • monday docs the value format per column type – get it wrong and you get a generic 'invalid value' error.

FAQ

Column value format errors – what's the trick?
Each column type has its own value shape. Status: {label:'Done'} or {index:1}. Date: {date:'2026-05-12'}. Person: {personsAndTeams:[{id:123, kind:'person'}]}. monday's developer docs list each format – get the shape wrong and you get a generic 'invalid value' error.
Why is my query slow / hitting rate limits?
GraphQL complexity. Each field has a score. Asking for items + their updates + their replies multiplies fast. Request only what you need; paginate large queries.
Cursor pagination vs page-based?
monday's items_page is cursor-based and recommended for new builds. The page-based items endpoint is deprecated but still works.
Can I use monday Webhooks?
Yes – create them in monday UI or via Create Webhook (not currently in this connector). Point them at the Automize webhook URL for event-driven flows.

Related connectors

See it working on your own data

Everything documented here ships with the platform – try the document tools free, or go live in 7 days.