Monday

SKILL.md

Monday.com (via Maton Gateway)

Access the Monday.com API with managed OAuth authentication. Manage boards, items, columns, groups, users, and workspaces using GraphQL.

🚀 Quick Start

Get Current User

curl -X POST https://gateway.maton.ai/monday/v2 \

-H "Authorization: Bearer $MATON_API_KEY" \

-H "Content-Type: application/json" \

-d '{"query": "{ me { id name email } }"}' | jq

🌐 Base URL

https://gateway.maton.ai/monday/v2

All requests use POST to the GraphQL endpoint.

🔐 Authentication

-H "Authorization: Bearer $MATON_API_KEY"

Set API Key

export MATON_API_KEY="YOUR_API_KEY"

🔑 Getting Your API Key

Sign in at https://maton.ai

Go to /settings

Copy your API key

🔗 Connection Management

Manage OAuth connections:

https://ctrl.maton.ai

📄 List Connections

curl "https://ctrl.maton.ai/connections?app=monday&status=ACTIVE" \

-H "Authorization: Bearer $MATON_API_KEY" | jq

➕ Create Connection

curl -X POST https://ctrl.maton.ai/connections \

-H "Authorization: Bearer $MATON_API_KEY" \

-H "Content-Type: application/json" \

-d '{"app": "monday"}' | jq

🔍 Get Connection

curl https://ctrl.maton.ai/connections/{connection_id} \

-H "Authorization: Bearer $MATON_API_KEY" | jq

❌ Delete Connection

curl -X DELETE https://ctrl.maton.ai/connections/{connection_id} \

-H "Authorization: Bearer $MATON_API_KEY" | jq

🌐 Complete OAuth

Open the returned url in your browser.

🎯 Specify Connection

curl -X POST https://gateway.maton.ai/monday/v2 \

-H "Authorization: Bearer $MATON_API_KEY" \

-H "Content-Type: application/json" \

-H "Maton-Connection: CONNECTION_ID" \

-d '{"query": "{ me { id name } }"}' | jq

📚 API Reference

👤 Current User

curl -X POST https://gateway.maton.ai/monday/v2 \

-H "Authorization: Bearer $MATON_API_KEY" \

-H "Content-Type: application/json" \

-d '{"query": "{ me { id name email } }"}'

👥 Users

curl -X POST https://gateway.maton.ai/monday/v2 \

-H "Authorization: Bearer $MATON_API_KEY" \

-H "Content-Type: application/json" \

-d '{"query": "{ users(limit: 20) { id name email } }"}'

🏢 Workspaces

curl -X POST https://gateway.maton.ai/monday/v2 \

-H "Authorization: Bearer $MATON_API_KEY" \

-H "Content-Type: application/json" \

-d '{"query": "{ workspaces(limit: 10) { id name kind } }"}'

📋 Boards

List Boards

curl -X POST https://gateway.maton.ai/monday/v2 \

-H "Authorization: Bearer $MATON_API_KEY" \

-H "Content-Type: application/json" \

-d '{"query": "{ boards(limit: 10) { id name state board_kind workspace { id name } } }"}'

Get Board (Full)

curl -X POST https://gateway.maton.ai/monday/v2 \

-H "Authorization: Bearer $MATON_API_KEY" \

-H "Content-Type: application/json" \

-d '{"query": "{ boards(ids: [BOARD_ID]) { id name columns { id title type } groups { id title } items_page(limit: 20) { cursor items { id name state } } } }"}'

Create Board

curl -X POST https://gateway.maton.ai/monday/v2 \

-H "Authorization: Bearer $MATON_API_KEY" \

-H "Content-Type: application/json" \

-d '{"query": "mutation { create_board(board_name: \"New Board\", board_kind: public) { id name } }"}'

Update Board

curl -X POST https://gateway.maton.ai/monday/v2 \

-H "Authorization: Bearer $MATON_API_KEY" \

-H "Content-Type: application/json" \

-d '{"query": "mutation { update_board(board_id: BOARD_ID, board_attribute: description, new_value: \"Board description\") }"}'

Delete Board

curl -X POST https://gateway.maton.ai/monday/v2 \

-H "Authorization: Bearer $MATON_API_KEY" \

-H "Content-Type: application/json" \

-d '{"query": "mutation { delete_board(board_id: BOARD_ID) { id } }"}'

🧩 Items

Get Items

curl -X POST https://gateway.maton.ai/monday/v2 \

-H "Authorization: Bearer $MATON_API_KEY" \

-H "Content-Type: application/json" \

-d '{"query": "{ items(ids: [ITEM_ID]) { id name state } }"}'

Create Item

curl -X POST https://gateway.maton.ai/monday/v2 \

-H "Authorization: Bearer $MATON_API_KEY" \

-H "Content-Type: application/json" \

-d '{"query": "mutation { create_item(board_id: BOARD_ID, group_id: \"GROUP_ID\", item_name: \"New item\") { id name } }"}'

Create Item with Column Values

curl -X POST https://gateway.maton.ai/monday/v2 \

-H "Authorization: Bearer $MATON_API_KEY" \

-H "Content-Type: application/json" \

-d '{"query": "mutation { create_item(board_id: BOARD_ID, group_id: \"GROUP_ID\", item_name: \"New task\", column_values: \"{\\\"status\\\": {\\\"label\\\": \\\"Working on it\\\"}}\") { id name } }"}'

Update Item Name

curl -X POST https://gateway.maton.ai/monday/v2 \

-H "Authorization: Bearer $MATON_API_KEY" \

-H "Content-Type: application/json" \

-d '{"query": "mutation { change_simple_column_value(board_id: BOARD_ID, item_id: ITEM_ID, column_id: \"name\", value: \"Updated name\") { id name } }"}'

Update Column Value

curl -X POST https://gateway.maton.ai/monday/v2 \

-H "Authorization: Bearer $MATON_API_KEY" \

-H "Content-Type: application/json" \

-d '{"query": "mutation { change_column_value(board_id: BOARD_ID, item_id: ITEM_ID, column_id: \"status\", value: \"{\\\"label\\\": \\\"Done\\\"}\") { id name } }"}'

Delete Item

curl -X POST https://gateway.maton.ai/monday/v2 \

-H "Authorization: Bearer $MATON_API_KEY" \

-H "Content-Type: application/json" \

-d '{"query": "mutation { delete_item(item_id: ITEM_ID) { id } }"}'

📊 Columns

Create Column

curl -X POST https://gateway.maton.ai/monday/v2 \

-H "Authorization: Bearer $MATON_API_KEY" \

-H "Content-Type: application/json" \

-d '{"query": "mutation { create_column(board_id: BOARD_ID, title: \"Status\", column_type: status) { id title type } }"}'

🗂 Groups

Create Group

curl -X POST https://gateway.maton.ai/monday/v2 \

-H "Authorization: Bearer $MATON_API_KEY" \

-H "Content-Type: application/json" \

-d '{"query": "mutation { create_group(board_id: BOARD_ID, group_name: \"New Group\") { id title } }"}'

📄 Pagination

First Page

curl -X POST https://gateway.maton.ai/monday/v2 \

-H "Authorization: Bearer $MATON_API_KEY" \

-H "Content-Type: application/json" \

-d '{"query": "{ boards(ids: [BOARD_ID]) { items_page(limit: 50) { cursor items { id name } } } }"}'

Next Page

curl -X POST https://gateway.maton.ai/monday/v2 \

-H "Authorization: Bearer $MATON_API_KEY" \

-H "Content-Type: application/json" \

-d '{"query": "{ next_items_page(cursor: \"CURSOR_VALUE\", limit: 50) { cursor items { id name } } }"}'

⚠️ Notes

GraphQL only (no REST)

IDs are strings

Escape JSON inside GraphQL mutations carefully

Default limit: 25 (max: 100)

🛠 Troubleshooting

Check API Key

echo $MATON_API_KEY

Test Auth

curl https://ctrl.maton.ai/connections \

-H "Authorization: Bearer $MATON_API_KEY" | jq

❌ Errors

Code Meaning

400 GraphQL / connection error

401 Invalid API key

403 Missing OAuth scope

429 Rate limited