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.
- Sign in to monday → click your avatar → Developers → My Access Tokens.
- Generate a personal API token (or use a team token for org automation).
- Copy the token (no specific prefix).
- 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.
| Operation | Category | What it does |
|---|---|---|
| Add file to column | General | Add a file to a Monday.com file column. |
| Archive item | General | Archive a Monday.com item. |
| Change column value | General | Change a column value on a Monday.com item. |
| Create item | General | Create a new item in a Monday.com board. |
| Create subitem | General | Create a subitem under a Monday.com parent item. |
| Create update | General | Add an update/comment to a Monday.com item. |
| Create webhook | General | Create a Monday.com webhook. |
| Delete item | General | Delete a Monday.com item. |
| Duplicate item | General | Duplicate a Monday.com item. |
| Get board | General | Get Monday.com board details with columns and groups. |
| Get item | General | Get Monday.com item details by ID. |
| List boards | General | List all Monday.com boards. |
| List groups | General | List groups in a Monday.com board. |
| List items | General | List items in a Monday.com board. |
| List subitems | General | List subitems of a Monday.com item. |
| List subscribers | General | List subscribers for a Monday.com item. |
| Move item to group | General | Move a Monday.com item to a different group. |
| Update item | General | Update 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.
| Parameter | Required | Type | Description |
|---|---|---|---|
Query query | Yes | text | |
Variables variables | No | text |
Tips
- Soft-delete (archives). Restorable via UI.
Change column value
Change a column value on a Monday.com item.
| Parameter | Required | Type | Description |
|---|---|---|---|
Query query | Yes | text | |
Variables variables | No | text |
Create item
Create a new item in a Monday.com board.
| Parameter | Required | Type | Description |
|---|---|---|---|
Board ID board_id | Yes | text | |
Item name item_name | Yes | text | |
Group ID group_id | No | text | |
Column values (JSON) column_values | No | textarea |
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.
| Parameter | Required | Type | Description |
|---|---|---|---|
Parent item ID parent_item_id | Yes | text | |
Subitem name item_name | Yes | text | |
Column values (JSON) column_values | No | textarea |
Create update
Add an update/comment to a Monday.com item.
| Parameter | Required | Type | Description |
|---|---|---|---|
Item ID item_id | Yes | text | |
Update text body | Yes | textarea |
Tips
- item_id + body. body supports rich text (HTML).
Create webhook
Create a Monday.com webhook.
| Parameter | Required | Type | Description |
|---|---|---|---|
Query query | Yes | text | |
Variables variables | No | text |
Delete item
Delete a Monday.com item.
| Parameter | Required | Type | Description |
|---|---|---|---|
Item ID item_id | Yes | text |
Tips
- Hard-delete. Irreversible after 30 days.
Duplicate item
Duplicate a Monday.com item.
| Parameter | Required | Type | Description |
|---|---|---|---|
Query query | Yes | text | |
Variables variables | No | text |
Get board
Get Monday.com board details with columns and groups.
| Parameter | Required | Type | Description |
|---|---|---|---|
Board ID board_id | Yes | text |
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.
| Parameter | Required | Type | Description |
|---|---|---|---|
Item ID item_id | Yes | text |
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.
| Parameter | Required | Type | Description |
|---|---|---|---|
Board ID board_id | Yes | text |
Tips
- Groups are board sections. Useful for filtering items by stage.
List items
List items in a Monday.com board.
| Parameter | Required | Type | Description |
|---|---|---|---|
Board ID board_id | Yes | text |
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.
| Parameter | Required | Type | Description |
|---|---|---|---|
Parent item ID item_id | Yes | text |
List subscribers
List subscribers for a Monday.com item.
| Parameter | Required | Type | Description |
|---|---|---|---|
Query query | Yes | text | |
Variables variables | No | text |
Move item to group
Move a Monday.com item to a different group.
| Parameter | Required | Type | Description |
|---|---|---|---|
Item ID item_id | Yes | text | |
Target group ID group_id | Yes | text |
Update item
Update column values on a Monday.com item.
| Parameter | Required | Type | Description |
|---|---|---|---|
Item ID item_id | Yes | text | |
Board ID board_id | Yes | text | |
Column values (JSON) column_values | Yes | textarea |
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.