canonical: https://jentic.com/apis/monday.com/monday-com-api

# monday.com API

Jentic publishes the only available OpenAPI specification for monday.com API, keeping it validated and agent-ready. Query and mutate boards, items, columns, groups, and automations through a single GraphQL endpoint. Supports workspace management, item creation with column values, file uploads, activity logs, and real-time updates across teams using monday.com's flexible board-based work management platform.

## For AI agents

Query and modify monday.com boards, items, groups, and column values through a single GraphQL endpoint. Supports workspace management, automations, and activity tracking for work management workflows.

## Scope

Does not handle file storage, video conferencing, or team messaging - use for board-based work tracking and item management only.

## Capabilities

- Query boards with nested items, groups, and column values in a single GraphQL request
- Create and update items with typed column values including status, date, people, and numbers
- Organize work into groups within boards for visual categorization and filtering
- Track activity logs on items to audit who changed what and when
- Upload files and attach them to specific items or update conversations
- Configure workspace-level permissions and team structures
- Subscribe to board and item changes via webhooks for real-time automation triggers

## Use cases

### AI Agent Work Item Automation

AI agents use the monday.com API through Jentic to create, update, and query work items without manual board interaction. An agent searches for the board mutation operation, loads the GraphQL schema, and executes item creation with typed column values in under a minute. This enables automated ticket creation from support channels, status updates from CI/CD pipelines, and cross-board item synchronization.

Example prompt: Create an item on board ID 12345 in group 'new_group' with column values: Status='Working on it', Person=user_id_678, Date='2026-05-15', and Text='Implement feature X'

### Cross-Board Reporting and Analytics

Query items across multiple boards with nested column values to build custom reports and dashboards. The monday.com GraphQL API returns boards, groups, items, and their typed column data in a single request. Teams aggregate completion rates, workload distribution, and deadline adherence metrics without exporting data manually from the monday.com UI.

Example prompt: Query all items from boards 111, 222, and 333 where status_column equals 'Stuck' and return item name, board name, assignee, and last updated timestamp

### Automated Status Synchronization

Keep monday.com board statuses synchronized with external systems by subscribing to webhooks and pushing updates via the GraphQL API. When a deployment completes in CI/CD, an agent updates the corresponding item's status column to 'Done'. When a support ticket is escalated, the linked monday.com item moves to 'Critical'. This bidirectional sync eliminates manual status copy between tools.

Example prompt: Update item ID 98765 on board 12345 to set status_column to 'Done' and add an update note 'Deployment v2.3.1 completed successfully'

### Team Workload Visibility

Retrieve people column assignments across boards to calculate individual team member workload. The API returns person IDs mapped to items with their status, due dates, and priority levels. Managers use this data to identify overloaded team members, redistribute work, and forecast capacity for upcoming sprints.

Example prompt: Query all items assigned to person_id 456 across all boards in workspace 789 where status is not 'Done' and return item name, board name, and due date

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| POST | / | Execute GraphQL queries and mutations for all board, item, and workspace operations |

## Key resources

- **Boards** — Query and configure boards with columns, groups, views, and permission settings
- **Items** — Create, update, and archive items with typed column values and nested subitems
- **Groups** — Organize items into named groups within boards for categorization
- **Columns** — Define typed data fields (status, date, people, numbers) and set their values on items
- **Updates** — Post threaded comments and file attachments on items for collaboration
- **Webhooks** — Subscribe to board and item change events for automation triggers

## Why Jentic

- **Setup:** Wiring the monday.com API by hand means managing its bearer token and hand-writing GraphQL queries and mutations with typed column value formats against a single POST endpoint. Through Jentic you install once, import the monday.com API from the API Directory, store the token once, and your agent calls it.
- **Permission scoping:** monday.com exposes one GraphQL endpoint where the board and item target travels in the request body, so you limit the agent to the operations it needs, such as creating an item. You choose the operations it may call, so a destructive mutation like deleting a board is not included unless you add it.
- **Credential handling:** Your monday.com token is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'create an item on a monday.com board', and Jentic returns the matching GraphQL mutation schema with typed column value formats so the agent calls the right operation without reading the API documentation.

## Related APIs

- **Asana** — Asana offers REST-based task management with deeper goal tracking and portfolio features
- **ClickUp API** — ClickUp provides REST-based project management with built-in time tracking and hierarchical spaces
- **Jira** — Jira is tailored for software teams with sprint planning, story points, and release management
- **Slack Web API** — Slack provides team messaging for notifications about monday.com board changes and item updates

## FAQ

### Why is there no official OpenAPI spec for monday.com API?

monday.com does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call monday.com API via structured tooling. It is validated against the live API and kept up to date. Get started with Jentic One, the self-hosted execution layer.

### What authentication does the monday.com API use?

The monday.com API uses Bearer token authentication. Include your API token in the Authorization header as 'Bearer {token}'. Tokens are generated from your monday.com admin panel. Through Jentic, these tokens are stored encrypted in your Jentic One instance and agents receive scoped credentials without touching raw secrets.

### Can I create items with specific column values using the monday.com API?

Yes. Use the create_item mutation with the column_values parameter set to a JSON string mapping column IDs to typed values. For example, a status column accepts its index value, a date column accepts 'YYYY-MM-DD', and a people column accepts an array of person IDs. The column type determines the expected value format.

### What are the rate limits for the monday.com API?

monday.com applies complexity-based rate limiting rather than per-request limits. Each query has a complexity cost based on the fields and depth requested. The default budget is 10,000,000 complexity points per minute. Query responses include a complexity field showing the cost and remaining budget.

### How do I query items across multiple boards through Jentic?

Search Jentic for 'query monday.com board items'. Jentic returns the POST / GraphQL endpoint schema. Construct a boards query with IDs parameter listing your target board IDs, nest items_page with column_values, and execute. Pagination uses cursor-based tokens returned in the response.

### Is the monday.com API GraphQL or REST?

The monday.com API is entirely GraphQL. All operations (queries and mutations) go through a single POST endpoint at https://api.monday.com/v2. You construct GraphQL queries to read data (boards, items, columns) and mutations to write data (create_item, change_column_value, archive_item).

### Can I set up webhooks for board changes?

Yes. Use the create_webhook mutation specifying the board_id, target URL, and event type (e.g., 'change_column_value', 'create_item'). monday.com sends POST payloads to your URL when matching events occur. You can also filter webhooks to specific columns using the config parameter.

### Can I limit what my agent is allowed to do with the monday.com API?

Yes. Because monday.com exposes a single GraphQL endpoint where the board and item target travels in the request body, your self-hosted Jentic One instance lets you decide exactly which operations the agent may call, such as creating an item or reading board data. Your own rules control the operation list, so a destructive mutation like deleting a board is not available to the agent unless you explicitly add it. The token that authorizes those calls is stored by your instance and injected at execution, so the agent only ever runs the operations you permit.