monday.com

1. Overview

Monday is a comprehensive work operating system that enables teams to run projects and workflows with complete confidence. It provides a flexible platform for project management, task tracking, and team collaboration through customizable boards, columns, and items.

Through GoInsight's Monday node, you can seamlessly integrate Monday.com operations into your automation workflows. You can achieve complete lifecycle management of boards, groups, items, and columns, including:

• Create and manage boards with custom configurations and permissions.
• Organize work by creating groups and columns to structure your boards.
• Track progress by creating, updating, and managing items within groups.
• Collaborate effectively by adding updates and managing item data.

2. Prerequisites

Before using this node, you need to have a valid Monday account. You may need administrator or specific permissions to create and manage API credentials. Additionally, ensure you have access to the boards and workspaces you want to manage through the API.

3. Credentials

For detailed guidance on how to obtain and configure credentials, please refer to our official documentation: Credentials Configuration Guide.

4. Supported Operations

Summary

This node primarily operates on resources such as Boards, Groups, Columns, Items, and Updates within Monday.com.

Operation Details

Create a Board

Creates a new board in Monday.com with specified name, type, and optional workspace placement.

Input Parameters:

• BoardName: The name of the board to create.
• BoardKind: The type of the board. Valid values: "public", "private", "share".

Output:

• BoardId (string): The ID of the newly created board.
• BoardName (string): The name of the newly created board.
• OriginalStatusCode (number): The original HTTP status code returned by the upstream API. Default 0 means the request did not reach upstream (e.g., timeout). Use for debugging.
• StatusCode (number): Operation status code: 200=Success (check ErrorMessage for business errors), -1=Parameter validation error, 500=System error (may retry).
• ErrorMessage (string): Error message if any error occurred, empty when successful.

Get a Board

Retrieves a board from Monday.com by its ID.

Input Parameters:

• BoardId: The ID of the board to retrieve.

Output:

• BoardId (string): The ID of the retrieved board.
• BoardName (string): The name of the retrieved board.
• OriginalStatusCode (number): The original HTTP status code returned by the upstream API. Default 0 means the request did not reach upstream (e.g., timeout). Use for debugging.
• StatusCode (number): Operation result code: 200 (success), 500 (request failed), -1 (parameter error).
• ErrorMessage (string): Error message if any error occurred, empty when successful.

Get Many Boards

Retrieves a list of Monday.com boards.

Options:

• BoardIds: Optional. List of Board IDs to be obtained, separated by commas. Leave blank to retrieve all accessible boards. Example: Single: 2057643590, Multiple: 2057643590,2057634461, Blank: Get all boards (limited by limit). ID source: can be obtained through the Monday.com interface URL (e.g. https://xxx.monday.com/boards/2057643590) Or call the Search Boards interface.
• Limit: The number of boards returned per page. Default 25, maximum 100. It takes effect when BoardIds is empty.
• Page: Page numbers, starting from 1. It takes effect when BoardIds is empty.

Output:

• Results (object-array): Board object array. Each Board contains the following fields: id (string): Board unique identifier, name (string): Board name, description (string | null): Board description, state (string): Board status, possible values: active, archived, deleted.
• Pagination (object): Pagination metadata object: page: Current page number, limit: Items per page, total_count: Number of boards returned in this response, has_more: Estimated indicator. Returns true if total_count == limit, suggesting there might be more data. Note: This is not 100% accurate as the last page might coincidentally have exactly limit items. Recommendation: Agent should continue fetching until total_count < limit to ensure all data is retrieved.
• OriginalStatusCode (number): The original HTTP status code returned by the Monday.com API. Default 0 means the request did not reach upstream (e.g., timeout). Use for debugging.
• StatusCode (number): Operation result status code: -1: Parameter validation error (such as BoardIds format error), 200: Successful, 500: Monday.com API internal error.
• ErrorMessage (string): Error message if any; empty if no errors.

Archive a Board

Archives a specified board on monday.com by its board ID.

Input Parameters:

• BoardId: The ID of the board to archive.

Output:

• ArchivedBoardId (string): The ID of the board that was archived.
• OriginalStatusCode (number): The original HTTP status code returned by the Monday.com API. Default 0 means the request did not reach upstream (e.g., timeout). Use for debugging.
• StatusCode (number): Operation result code: -1 indicates parameter error, 200 indicates success, 500 indicates API or GraphQL error, or other HTTP error codes.
• ErrorMessage (string): Error message describing the failure, empty if operation successful.

Create a Board Group

Creates a new group on a specified Monday.com board for organizing items.

Input Parameters:

• BoardId: The ID of the Monday.com board where the group will be created. You can obtain Board IDs by: Calling Get Boards or Search Boards action, Copying from the board URL in Monday.com (e.g., https://yourcompany.monday.com/boards/1234567890), Using the board ID from a previous workflow step.
• GroupName: The name of the group to be created.
• GroupColor: The color of the group (optional). Supports: Color Names (case-insensitive): pink, dark_pink, dark_red, red, orange, light_orange, yellow, gold, lime_green, green, dark_green, teal, light_blue, blue, purple, dark_purple, brown, light_gray, dark_gray. HEX Values: Any valid hex color code (e.g., #ff5ac4, #e2445c). If not specified, Monday.com will use the default color.

Output:

• GroupId (string): The ID of the newly created group.
• OriginalStatusCode (number): The original HTTP status code returned by the upstream API. Default 0 means the request did not reach upstream (e.g., timeout). Use for debugging.
• StatusCode (number): Operation result code: 200 for success; 500 for API error; -1 for parameter validation error.
• ErrorMessage (string): Error message if an error occurred; empty otherwise.

Get Many Board Groups

Retrieve all group details of a specified Monday.com board.

Input Parameters:

• BoardId: The ID of the board to retrieve group information from.

Output:

• Groups (object-array): A list of group objects returned by the API.
• OriginalStatusCode (number): The original HTTP status code returned by the upstream API. Default 0 means the request did not reach upstream (e.g., timeout). Use for debugging.
• StatusCode (number): Operation status code: 200 for success, -1 for invalid parameters, 500 for API or internal errors.
• ErrorMessage (string): Error description if any; empty if the operation succeeds.

Delete a Board Group

DESTRUCTIVE OPERATION: Deletes a group on a Monday.com board. All items (tasks) within this group will be permanently deleted and cannot be recovered. Use with caution.

Input Parameters:

• BoardId: The ID of the board containing the group. You can obtain Board IDs by calling the Get Boards or Search Boards action. Board IDs are numeric strings (e.g., '1234567890').
• GroupId: The ID of the group to be deleted. You can obtain Group IDs by calling the Get Board Groups action. Group IDs are alphanumeric strings (e.g., 'group_abc123').

Output:

• Deleted (bool): Indicates whether the group was successfully deleted.
• ErrorType (string): Machine readable error type code. Possible values: INVALID_TOKEN: Authentication failed, Token is invalid or expired. PERMISSION_DENIED: Insufficient permissions to perform this action. RATE_LIMITED: Request frequency exceeds the limit. GRAPHQL_ERROR: GraphQL query or business logic error (e.g. Group does not exist). SERVER_ERROR: Upstream server error (5xx). NETWORK_ERROR: Network connection failed. TIMEOUT: Request timeout. UNEXPECTED_ERROR: Unexpected internal exception. Returns an empty string when the operation is successful.
• OriginalStatusCode (number): The original HTTP status code returned by the upstream Monday.com API. The default value is 0, indicating that the request did not reach the upstream (such as network timeout, connection failure). Common values: 200 (successful), 401 (authentication failed), 403 (insufficient permissions), 429 (request frequency exceeded), 500+(server error). Used for debugging and troubleshooting.
• StatusCode (number): Operation status code: 200 for success; 500 for API error; -1 for parameter validation error.
• ErrorMessage (string): Error message if an error occurred; empty otherwise.

Create a Board Column

Creates a new column on a Monday.com board with the specified title and type.

Input Parameters:

• BoardId: Board ID. Can be retrieved via the following methods: Call the Get Boards API to retrieve the list of boards. Open the board in the Monday.com web interface; the number in the URL is the Board ID (e.g., https://xxx.monday.com/boards/1234567890). Format: Numeric string, e.g., "1234567890".
• Title: The title of the new column.
• ColumnType: Column Type. Defines the data format and interaction behavior of the column. Common Types: text: Single-line text, long_text: Multi-line text, status: Status labels (colored, e.g., Done/In Progress), date: Date picker, timeline: Timeline (start and end dates), people: People selector, dropdown: Dropdown menu, numbers: Numbers, checkbox: Checkbox, email: Email address, phone: Phone number, link: Hyperlink. Full list of types: https://developer.monday.com/api-reference/docs/column-types. Note: Column types cannot be modified after creation; the column must be deleted and recreated.

Output:

• ColumnId (string): Unique identifier for the newly created column. Format: {type}_{random_string} (such as date_xt4a2hw). This ID can be used for subsequent operations such as updating columns and deleting columns.
• OriginalStatusCode (number): The original HTTP status code returned by the upstream API. Default 0 means the request did not reach upstream (e.g., timeout). Use for debugging.
• StatusCode (number): Operation result code: 200 for success; 500 for API error; -1 for parameter validation error.
• ErrorMessage (string): Error message if an error occurred; empty otherwise.

Get Many Board Columns

Retrieves all columns on a specified Monday.com board.

Input Parameters:

• BoardId: The unique identifier of the Monday.com board. How to get Board ID: 1. Open your board in Monday.com. 2. Check the URL: https://yourcompany.monday.com/boards/1234567890. 3. The number after /boards/ is your Board ID. Alternatively, use the Search Boards or Get Many Boards action to retrieve Board IDs programmatically. Example: "2057643590".

Output:

• Columns (object-array): A JSON string list of column objects with fields: id, title, type, settings_str.
• ErrorType (string): Error type classification. Possible values: VALIDATION_ERROR: Input parameter validation failed, INVALID_TOKEN: Authentication token is invalid or expired, NOT_FOUND: Board or resource not found, GRAPHQL_ERROR: Monday.com GraphQL API returned an error, TIMEOUT: Request timed out, NETWORK_ERROR: Network connection failed, SYSTEM_ERROR: Unexpected system error.
• OriginalStatusCode (number): The original HTTP status code returned by the Monday.com API. Default 0 means the request did not reach upstream (e.g., timeout). Use for debugging.
• StatusCode (number): Overall operation status code: 200 for success; 500 for API error; -1 for parameter validation error.
• ErrorMessage (string): Error message if an error occurred; empty otherwise.

Create an Item in a Board's Group

Creates a new item in a specified group within a Monday.com board.

Input Parameters:

• BoardId: The unique identifier of the Monday.com board. How to get: Use the "List Boards" or "Get Board" action to retrieve board IDs. Alternatively, find it in the board URL (e.g., https://your-workspace.monday.com/boards/1234567890 → BoardId = 1234567890).
• GroupId: The unique identifier of the group (section) within the board. How to get: Use the "Get Board Groups" action or check the board structure in Monday.com. Group IDs typically look like group_abc123.
• ItemName: The name/title of the new item to create.

Options:

• ColumnValues: Key value pairs with additional column values. Key is the column ID, and Value is the column value. Common column types: Text: {"text_col_id": "Sample text"}, Status: {"status_col_id": {"label": "Working on it"}}, Date: {"date_col_id": {"date": "2025-06-01"}}, Person: {"person_col_id": {"personsAndTeams": [{"id": 12345, "kind": "person"}]}}. How to obtain column IDs: Use the Get Board Columns interface or view it in Monday.com settings. Example: {"text_abc123": "John Doe", "status_xyz456": {"label": "Done"}}.

Output:

• ItemId (string): The unique identifier of the newly created item.
• OriginalStatusCode (number): The original HTTP status code returned by the Monday.com API. Default 0 means the request did not reach upstream (e.g., timeout). Use for debugging.
• StatusCode (number): Operation status code: 200 for success, 500 for API/internal error, -1 for parameter validation error.
• ErrorMessage (string): Error message if any; empty if operation succeeds.

Get an Item

Retrieves a specific item by its ID from Monday.com board, including its basic details and column values.

Input Parameters:

• ItemId: The ID of the item to retrieve.

Output:

• Id (string): The unique identifier of the retrieved item.
• Name (string): The name of the retrieved item.
• BoardId (string): The ID of the board containing the item.
• GroupId (string): The ID of the group containing the item.
• ColumnValues (object-array): A list of column value objects, each with fields: Id, Title, Text, Value.
• OriginalStatusCode (number): The original HTTP status code returned by the upstream API. Default 0 means the request did not reach upstream (e.g., timeout). Use for debugging.
• StatusCode (number): Operation status code: 200 for success, -1 for parameter validation error, 500 for API/internal error.
• ErrorMessage (string): Error message if any; empty if operation succeeds.

Get Many Items

Retrieves multiple items by their IDs from a Monday.com board, including their basic details and column values.

Input Parameters:

• ItemIds: A comma-separated list of Monday.com item IDs to retrieve.

Output:

• Items (object-array): A list of item objects retrieved. Each object contains: Id, Name, BoardId, GroupId, ColumnValues.
• OriginalStatusCode (number): The original HTTP status code returned by the upstream API. Default 0 means the request did not reach upstream (e.g., timeout). Use for debugging.
• StatusCode (number): Operation result code: 200 (success), 500 (request failed), -1 (parameter error).
• ErrorMessage (string): Error message if any error occurred, empty when successful.

Get Items by Column Value

Retrieves items from a Monday.com board that match a specified column value.

Input Parameters:

• BoardId: The unique identifier of the Monday.com board to query. You can obtain this ID by: Using the Get Boards action to list all boards, Checking the URL when viewing a board (e.g., https://yourworkspace.monday.com/boards/1234567890), Using the board picker in Monday.com UI. Example: "2057643590".
• ColumnId: The unique identifier of the column to filter by. Column IDs are system-generated (e.g., 'text_mktta2z1', 'date_mktt2fhw'). You can obtain this ID by: Using the Get Board Columns action, Inspecting the board structure via API, Checking column settings in Monday.com UI (Developer mode). Note: This is NOT the column title (e.g., 'Status'), but the internal ID. Example: "date_mktt2fhw".
• ColumnValue: The value to match in the specified column. Matching is exact and case-sensitive. Format requirements by column type: Text columns: Plain text (e.g., 'John Doe'), Date columns: ISO 8601 format YYYY-MM-DD (e.g., '2005-06-30'), Status columns: Exact status label (e.g., 'Done', 'In Progress'), Number columns: Numeric string (e.g., '100', '99.5'), Email columns: Email address (e.g., 'user@example.com'). Note: For complex column types (e.g., People, Timeline), refer to Monday.com API documentation for value format. Example: "2005-06-30" (for date column).

Options:

• Limit: Maximum number of items to return per request. Range: 1-500. Default: 25. Use pagination (Cursor) to retrieve more results.
• Cursor: Pagination cursor from previous response. Leave empty for first page. Use the 'NextCursor' from the response to fetch the next page.

Output:

• Items (object-array): List of items matching the filter. Each item is an object with the following structure: Id (string): Unique identifier of the item, Name (string): Display name of the item, ColumnValues (array): Array of column value objects, each containing: Id (string): Column ID (e.g., 'text_mktta2z1'), Type (string): Column type (e.g., 'text', 'status', 'date', 'number'), Text (string): Human-readable display value, Value (string): Raw JSON value (for complex types like status/date).
• Pagination (object): Pagination metadata. Fields: returned_count (number of items in this response), has_more (boolean, true if more pages exist), next_cursor (string, use this as Cursor input to fetch next page).
• OriginalStatusCode (number): The original HTTP status code returned by the upstream Monday.com API. The default value is 0, indicating that the request did not reach the upstream (such as network timeout, connection failure). Common values: 200 (successful), 401 (authentication failed), 403 (insufficient permissions), 429 (request frequency exceeded), 500+(server error). Used for debugging and troubleshooting.
• StatusCode (number): Operation status code: 200 for success, -1 for parameter validation error, 500 for API/internal error.
• ErrorMessage (string): Error message if any; empty if operation succeeds.

Change a Column Value for a Board Item

Changes the value of a specific column in a specified item on a Monday.com board.

Input Parameters:

• BoardId: The ID of the board containing the item. You can get this by calling Get Boards or by checking the URL in Monday.com web interface (e.g., monday.com/boards/123456).
• ItemId: The ID of the item whose column will be updated. You can get this by calling Get Items or Search Items, or by clicking the item in Monday.com to view its detail page URL.
• ColumnId: The ID of the column to change. You can get this by calling Get Columns, or by right-clicking the column header in Monday.com to view column settings.
• ColumnValue: The new value for the column. The format depends on the column type: Common column types: Text: "New text value", Status: {"label": "Done"}, Date: {"date": "2024-01-15"}, People: {"personsAndTeams": [{"id": 12345678, "kind": "person"}]}, Numbers: 42, Dropdown: {"labels": ["Option A"]}, Timeline: {"from": "2024-01-01", "to": "2024-01-31"}. For complete column type reference, see Monday.com API documentation or use Get Columns to check your column type. Example (Text): "Updated description". Example (Status): {"label": "Working on it"}.

Output:

• ColumnValueId (string): The ID of the updated item (same as ItemId input). Monday.com API returns the item ID after updating the column value.
• OriginalStatusCode (number): The original HTTP status code returned by Monday.com API. Default 0 means the request did not reach upstream (e.g., timeout). Use for debugging: 0: Did not reach upstream, 200: Success, 400: Bad request, 401: Invalid token, 403: Permission denied, 404: Board/Item/Column not found, 429: Rate limited, 5xx: Monday.com server error.
• StatusCode (number): Operation status code: 200 for success, -1 for parameter validation error, 500 for API/internal error.
• ErrorMessage (string): Error message if any; empty if operation succeeds.

Change Multiple Column Values for a Board Item

Changes multiple column values for a specified item on a Monday.com board in a single operation.

Input Parameters:

• BoardId: The ID of the board containing the item can be obtained through the Get Boards or Search Boards interfaces, or found in the Board URL on the Monday.com interface (format: https://xxx.monday.com/boards/[BoardId]). Example: "2057643590".
• ItemId: The ID of the item whose columns will be updated.
• ColumnValues: Key value pairs for column values. Key is the column ID (such as 'status'), and Value is the column value object (format varies depending on the column type). Common column type formats: Text Column: "text_comlumc_id": "Text Content", Status column: "status_comlumc_id": {"label": "Done"}, Date column: "date_comlumc_id": {"date": "2024-01-15"}, People column: "people_comlumc_id": {"personsAndTeams": [{"id": 12345, "kind": "person"}]}. Please refer to the official documentation of Monday.com for the complete column types. Example: {"text_mktta2z1": "Updated description", "color_mkttwksb": {"label": "Stuck"}, "date_mktt2fhw": {"date": "2024-01-15"}}.

Output:

• ColumnValuesId (string): The unique identifier of the change operation returned by the mutation.
• OriginalStatusCode (number): The original HTTP status code returned by Monday API. Default 0 means the request did not reach upstream (e.g., timeout). Use for debugging.
• StatusCode (number): Overall operation status code: 200 for success, 500 for API or internal error, -1 for parameter validation error.
• ErrorMessage (string): Error message if any; empty if the operation succeeds.

Move an Item to a Group

WARNING: This action PERMANENTLY moves an item to a different group and CANNOT BE UNDONE. Risk Level: MEDIUM. Side Effects: May trigger Monday.com automations/notifications if configured on the target group. Use with caution in Agent autonomous scenarios.

Input Parameters:

• ItemId: The ID of the item to move. Must be a numeric string (e.g., "2059327296"). Do NOT include prefixes like 'item_'. You can get this ID from the 'id' field in 'Get Items' or 'Search Items' responses.
• GroupId: The ID of the target group to which the item will be moved. You can get group IDs from the 'Get Boards' action (check the 'groups' array in the response). Format: Usually starts with 'group_' prefix (e.g., 'group_mktts1dw').

Output:

• MovedItemId (string): The ID of the moved item returned by the mutation.
• OriginalStatusCode (number): The original HTTP status code returned by Monday.com API. Default 0 means the request did not reach upstream (e.g., timeout). Use for debugging.
• StatusCode (number): Overall operation status code: 200 for success, -1 for parameter validation error, 500 for API/internal error.
• ErrorMessage (string): Error message if any; empty if operation succeeds.

Delete an Item

Deletes a specified item on Monday.com, this action cannot be undone.

Input Parameters:

• ItemId: The ID of the item to be deleted.

Output:

• DeletedItemId (string): The unique identifier of the deleted item.
• OriginalStatusCode (number): The original HTTP status code returned by the Monday.com API. Default 0 means the request did not reach upstream (e.g., timeout). Use for debugging.
• StatusCode (number): Overall operation status code: 200 for success, -1 for parameter validation error, 500 for API/internal error.
• ErrorMessage (string): Error message if any; empty if operation succeeds.

Add an Update to an Item

Adds a new update to a specified item on Monday.com.

Input Parameters:

• ItemId: The ID of the item to which the update will be added.
• UpdateText: The body text of the update to be added.

Output:

• UpdateId (string): The unique identifier of the newly created update.
• OriginalStatusCode (number): The original HTTP status code returned by the Monday.com API. Default 0 means the request did not reach upstream (e.g., timeout). Use for debugging.
• StatusCode (number): Operation status code: 200 for success, 500 for API/internal error, -1 for parameter validation error.
• ErrorMessage (string): Error message if any; empty if operation succeeds.

5. Example Usage

This section will guide you through creating a simple workflow to create a new board in your Monday.com workspace. This example demonstrates the foundational step for setting up project management within Monday.com.

The workflow consists of Start -> Monday -> Answer nodes, where we'll use the "Create a Board" operation to establish a new project board.

Step-by-step guide:

1. Add the tool node:
   • In the workflow canvas, click the "+" button to add a new node.
   • In the popup panel, select the "Tools" tab.
   • Find and select Monday from the tools list.
   • In the Monday supported operations list, click and select Create a Board, which will add a corresponding node to the canvas.
2. Configure the node:
   • Click on the newly added Create a Board node, and the configuration panel will expand on the right side.
   • Credential Configuration: At the top of the panel, find the credential field. Click the dropdown menu and select your pre-configured Monday credentials.
   • Parameter Configuration:
   • BoardName: Enter a name for your new board, for example "Marketing Campaign Q4".
   • BoardKind: Specify the board type. Enter "public" for a public board, "private" for a private board, or "share" for a shared board.
3. Run and verify:
   • Once all required parameters are properly filled, the error indicators in the top right corner of the workflow canvas will disappear.
   • Click the "Test Run" button in the top right corner of the canvas to execute the workflow.
   • After successful execution, you can click the log icon in the top right corner to view detailed input and output of the node, verifying that the operation was successful.

After completing these steps, your entire workflow will be configured. Click "Test Run" and a new board will be successfully created in your Monday.com workspace with the specified name and type.

6. FAQs

Q: I'm getting a 401 or 403 error when trying to access Monday.com API. What should I do?

A: This typically indicates an authentication or permission issue. Please check the following:

• Verify that your API token is correctly configured in the credentials.
• Ensure your Monday.com account has the necessary permissions to perform the requested operation.
• Check if your API token has expired and needs to be regenerated.

Q: Why am I getting a parameter validation error (-1 status code)?

A: Parameter validation errors occur when required fields are missing or have invalid values. Please ensure:

• All required parameters are filled with valid data.
• Board IDs, Item IDs, and Group IDs are valid and exist in your Monday.com workspace.
• JSON strings for column values follow Monday.com's expected schema format.

Q: How do I find the IDs for boards, groups, and items?

A: You can obtain these IDs through several methods:

• Use the "Get many Boards" operation to retrieve all your board IDs.
• Use "Get many Board Groups" with a board ID to get all group IDs within that board.
• Use "Get many Items" to retrieve item IDs from your boards.
• Check the Monday.com web interface URL when viewing specific items - the ID is often visible in the URL.

Q: What column types are supported when creating columns?

A: Monday.com supports various column types including "text", "status", "date", "numbers", "person", "timeline", "dropdown", and many others. Refer to Monday.com's official documentation for the complete list of supported column types and their specific configuration requirements.

7. Official Documentation

For more detailed information about Monday.com's API capabilities and advanced features, please refer to the Monday Official API Documentation.