---
title: Monday.com API Integration on Truto
slug: mondaycom
category: Ticketing
canonical: "https://truto.one/integrations/detail/mondaycom/"
---

# Monday.com API Integration on Truto



**Category:** Ticketing  
**Status:** Generally available

## Unified APIs

### Unified Knowledge Base API

- **Page-Content** — Represents the content of a page
- **Pages** — Represents the pages, posts, articles in a knowledge base

### Unified User Directory API

- **Groups** — Groups are a collection of users in the source application. In some applications, they might also be called Teams.
- **Licenses** — Licenses represent concepts like user seats in apps that support them
- **Me** — 
- **Organizations** — Organizations are the top level entity in the source application. Users are associated with an organization.
- **Roles** — The Role object represents a role of a User.
- **Users** — The User object represents a User.
- **Workspaces** — Workspaces represent concepts like teams, workspaces, projects in apps that support them

### Unified Ticketing API

- **Attachments** — Attachments are the files associated with a ticket or a comment.
- **Collections** — Tickets and contacts can be grouped into Collections. Collection resource usually maps to the various grouping systems used in the underlying product. Some examples are lists, projects, epics, etc. You can differentiate between these grouping systems using the type attribute of a Collection.
- **Comments** — Comments represent the communication happening on a Ticket, both between a User and a Contact and the internal things like notes, private comments, etc. A Ticket can have one or more Comments.
- **Fields** — Fields represent the attributes defined for various entities in the underlying product. Depending on the underlying product, custom attributes can be defined by a User on various entities like Ticket, Contact, etc. is_user_defined attribute within Field can be used to differentiate between custom and system defined Fields.
- **Ticket Status** — Ticket Status represents the completion level of the Ticket. Some products provide customizing the Ticket Status.
- **Tickets** — Core resource which represents some work that needs to be carried out. Tickets are usually mapped to issues, tasks, work items, etc. depending on the underlying product.
- **Workspaces** — Workspaces represent the top-level subdivision in a ticketing system. They usually have their own set of settings, tickets, statuses, priorities and users. Some of the usual terminologies used by the products for the top-level subdivision are projects, bases, spaces, workspace, etc. A Workspace could belong to an Organization.

### Unified Search API

- **Search** — Search endpoint for all the apps.

## MCP-ready AI tools

Truto exposes 24 tools for Monday.com that AI agents can call directly.

- **list_all_monday_com_users** — List monday.com users with full profile details. Returns: id, name, email, account, birthday, country_code, created_at, current_language, enabled, is_admin, is_guest, is_pending, is_view_only, is_verified, join_date, last_activity, location, mobile_phone, phone, photo_original, photo_small, photo_thumb, photo_tiny, photo_thumb_small, sign_up_product_kind, teams, time_zone_identifier, title, url,…
- **delete_a_monday_com_user_by_id** — Delete a monday.com user from a workspace. Returns: id. Required: id, workspace_id.
- **list_all_monday_com_board_items** — List items on a monday.com board using cursor-based pagination. Returns each item's id, name, state, created_at, updated_at, column_values, board, creator, subscribers, parent_item, email, and relative_link. Required: board_id.
- **get_single_monday_com_board_item_by_id** — Get a single monday.com board item by id. Returns the item object including id, name, state, created_at, updated_at, column_values, assets, board, group, subitems, subscribers, creator, and relative_link. Required: id.
- **create_a_monday_com_board_item** — Create a new item on a monday.com board, optionally within a specific group and with pre-filled column values. Returns the new item's id. Required: board_id, name.

REQUIRES A WRITE SCOPE. monday.com rejects create_item with 403 "User unauthorized to perform action" (UserUnauthorizedException) unless the connection carries boards:write. Reads such as boards.list and board-items.list work with read-only scopes, so a working read does NOT imply this will succeed.

SILENT FAILURE - IMPORTANT. On that rejection monday.com still answers HTTP 200, carrying the error in the GraphQL errors array with data.create_item = null. Because this method reads data.create_item, the caller receives HTTP 200 with a null body and NO error. Treat a null response as a failure, not as success: verify by calling board-items.list for the board and confirming the item count rose. A successful call returns an object containing id.
- **list_all_monday_com_board_items_search** — List and search monday.com board items filtered by column-level query rules. Returns each item's id, name, state, created_at, updated_at, column_values, board, and creator. Required: board_id.
- **list_all_monday_com_boards** — List monday.com boards. Returns: id, name, description, board_kind, type, updated_at.
- **get_single_monday_com_board_by_id** — Get a single monday.com board by id. Returns: id, name, description, board_kind, type, updated_at. Required: id.
- **list_all_monday_com_workspaces** — List monday.com workspaces with pagination. Returns: id, name, created_at. The default page size is 25 and page numbering starts at 1.
- **list_all_monday_com_accounts** — Get the authenticated user's monday.com account metadata. Returns: id, name, slug, tier, country_code, active_members_count, first_day_of_the_week, logo, sign_up_product_kind, show_timeline_weekends, plan, products.
- **get_single_monday_com_doc_by_id** — Get a single monday.com doc by its internal identifier. Returns the doc object including id, name, url, relative_url, doc_folder_id, doc_kind, object_id, workspace, settings, created_by, and created_at. Required: id.
- **list_all_monday_com_docs** — List monday.com Workdocs with their metadata. Returns: id, url, created_at. Default page size is 25.
- **list_all_monday_com_docs_blocks** — List content blocks for a monday.com document by doc id. Returns: id, doc_id, type, content, parent_block_id, position, created_by, created_at, updated_at. Required: doc_id.
- **get_single_monday_com_update_by_id** — Get a single monday.com update by id. Returns: id, created_at, updated_at. Required: id.
- **list_all_monday_com_updates** — List monday.com updates for a specific item by ticket_id. Returns: id, created_at, updated_at. Max 100 per page.
- **list_all_monday_com_workspace_users** — List users subscribed to a monday.com workspace. Returns: account, birthday, country_code, created_at, current_language, email, enabled, id, is_admin, is_guest, is_pending, is_view_only, is_verified, join_date, last_activity, location, mobile_phone, name, phone, photo_original, photo_small, photo_thumb, photo_thumb_small, photo_tiny, sign_up_product_kind, teams, time_zone_identifier, title, url,…
- **list_all_monday_com_me** — Get the currently authenticated monday.com user (the "me" object). Returns: id, name, created_at, is_guest, is_admin, is_verified, is_view_only, is_pending, account. No parameters required — the API token identifies the user.
- **list_all_monday_com_columns** — List columns on a monday.com board by board ID. Returns: id, title, archived, description, settings_str, type, width. Required: board_id.
- **list_all_monday_com_assets** — List assets (files) attached to a specific monday.com item. Returns: id, name, public_url (a temporary download link, valid about one hour), url, created_at, file_extension, file_size. Required: item_id. Pass public_url to assets.download to get the file.
- **monday_com_assets_download** — Download a monday.com file (asset). Call assets.list for the item first and pass the asset's public_url, exactly as returned, as path, with base set to its origin; do not use url, which needs a browser session. public_url is valid for about one hour. Returns the raw file bytes as a downloadable file.
- **create_a_monday_com_asset** — Upload a file to a file column on a specific monday.com item via multipart form data. Returns: id, url, created_at. Required: query, variables (item_id, column_id, file). Files up to 500 MB.
- **list_all_monday_com_teams** — List monday.com teams with their owners and member users. Returns: id, name, picture_url, owners, users.
- **get_single_monday_com_team_by_id** — Get a single monday.com team by id. Returns: id, name, picture_url, owners, users. Required: id.
- **create_a_monday_com_subitem** — Creates a subitem under parent_item_id (monday create_subitem). Used by ticket create when parent_ticket is sent.

## How it works

1. **Link your customer's Monday.com account.** Use Truto's frontend SDK; we handle every OAuth and API key flow so you don't need to create the OAuth app.
2. **Authentication is automatic.** Truto refreshes tokens, stores credentials securely, and injects them into every API request.
3. **Call Truto's API to reach Monday.com.** The Proxy API is a 1-to-1 mapping of the Monday.com API.
4. **Get a unified response format.** Every response uses a single shape, with cursor-based pagination and data in the `result` field.

## Use cases

- **Escalate support issues to engineering teams in Monday.com** — Customer support SaaS platforms can let agents push unresolved bugs or feature requests directly into Monday.com boards as tickets, keeping engineering teams in their preferred workflow while maintaining bi-directional status sync.
- **Auto-create Monday.com tickets from monitoring alerts** — Security, observability, and infrastructure SaaS products can automatically generate actionable Monday.com items when incidents or vulnerabilities are detected, ensuring IT teams triage issues without leaving their Work OS.
- **Sync customer onboarding tasks into Monday.com workspaces** — Customer success and onboarding platforms can programmatically create structured ticket groups in Monday.com for implementation teams, mapping deal data like contract value and go-live dates into custom fields.
- **Enrich Monday.com tickets with external context** — SaaS products that hold customer health scores, usage analytics, or CRM data can push live context into Monday.com items as comments or field updates, giving internal teams full visibility without switching tools.
- **Centralize cross-platform ticket search and reporting** — Analytics or operations SaaS products can query Monday.com alongside other ticketing systems through a single interface, enabling unified reporting across all tools an organization uses for task and issue tracking.

## What you can build

- **Two-way ticket status sync** — Keep ticket statuses synchronized between your product and Monday.com boards so that when an item moves to 'Done' in Monday, your platform reflects the resolution automatically.
- **Dynamic field mapping UI** — Query Monday.com board schemas via the Unified Ticketing API's Fields resource to let your users map your product's data fields to Monday's custom columns at setup time.
- **One-click 'Push to Monday' action** — Let your users create a Monday.com item from any object in your product — pre-populating the board, group, status, and custom fields based on user-configured mappings.
- **Threaded activity log in Monday.com updates** — Post audit trails, status changes, or contextual notes from your platform into Monday.com item updates (Comments) so internal teams see a full history without leaving their board.
- **Attachment forwarding for bug reports** — Automatically attach screenshots, log files, or diagnostic exports from your product to the corresponding Monday.com ticket using the Attachments resource.
- **Cross-tool ticket search** — Use the Unified Search API to let your users find Monday.com items alongside tickets from other integrated systems, enabling a single search bar across all connected platforms.

## FAQs

### How does authentication work for Monday.com integrations through Truto?

Monday.com uses OAuth 2.0 for third-party integrations. Truto manages the full OAuth flow, token storage, and refresh cycle so your team never handles credentials directly. Your end users authorize access through a standard consent screen.

### How does Truto handle Monday.com's custom fields since every board has a different schema?

Monday.com boards have dynamic column structures. The Unified Ticketing API's Fields resource lets you query a board's column definitions at runtime, so your application can discover and map to custom columns like Status, Date, or Dropdown fields without hardcoding schemas.

### Does Monday.com use REST or GraphQL, and does that affect how I use Truto?

Monday.com exposes a GraphQL API natively. Truto abstracts this behind its Unified APIs, so you interact with consistent REST-style resources (Tickets, Comments, Fields, etc.) regardless of the underlying protocol.

### What Monday.com rate limits should I be aware of?

Monday.com enforces complexity-based rate limits on its GraphQL API — each query costs a certain number of complexity points, with limits varying by plan (typically 10,000,000 complexity points per minute for standard plans). Truto handles pagination and query optimization to stay within these limits.

### Which Unified APIs are available for Monday.com through Truto?

Monday.com is supported through the Unified Ticketing API (Tickets, Comments, Attachments, Fields, Ticket Status, Collections, Workspaces), the Unified User Directory API (Users, Organizations, Workspaces, Licenses, Me), the Unified Knowledge Base API (Pages, Page-Content), and the Unified Search API. No pre-built tools are available yet, but custom tools can be built on request.

### Can I create tickets in specific Monday.com boards and groups?

Yes. Monday.com boards map to Workspaces/Collections in the Unified Ticketing API. You can query available boards and groups, then target a specific one when creating tickets so items land in the correct queue or section.
