Worktables

Interact with Monday.com boards and items

Actions26

Overview

This node interacts with Monday.com to update column values of a specific item on a board. It allows users to modify multiple columns of an existing item or subitem by specifying new values for each column. This is useful in scenarios where you want to automate updates to project tasks, status changes, or any data tracked within Monday.com boards.

For example, you might use this node to:

Automatically update the status and priority columns of a task item when certain conditions are met.
Change due dates or assignees on items based on external triggers.
Modify multiple fields of a subitem related to a parent task.

Properties

Name	Meaning
Workspace Name or ID	Select the workspace containing the board.
Board Name or ID	Select the Monday.com board where the item exists.
Item Name or ID	Select the item whose column values you want to update.
Is Subitem	Boolean flag indicating if the target is a subitem instead of a main item.
Subitem Name Or ID	If updating a subitem, select the specific subitem ID.
Column Values	A collection of column-value pairs specifying which columns to update and their new values.

The Column Values property supports multiple entries, each requiring:

Column Name or ID: The identifier of the column to update.
New Value: The new value to set for that column (as a string).

Output

The node outputs JSON data representing the result of the mutation request to Monday.com. Typically, this includes the updated item's ID confirming the successful update.

Example output structure:

[
  {
    "json": {
      "data": {
        "change_multiple_column_values": {
          "id": "123456789"
        }
      }
    }
  }
]

No binary data output is produced by this operation.

Dependencies

Requires an API key credential for Monday.com with appropriate permissions to read and write items on boards.
The node makes HTTP POST requests to the Monday.com GraphQL API endpoint (https://api.monday.com/v2).
Proper configuration of the API key credential in n8n is necessary.

Troubleshooting

API Key Not Found: The node will throw an error if the API key credential is missing or invalid. Ensure the credential is configured correctly.
Missing Required Parameters: Errors occur if required parameters like boardId, itemId, or columnValues are not provided.
Invalid Column IDs or Values: Providing incorrect column IDs or improperly formatted values may cause the API to reject the update.
Subitem Handling: When updating subitems, ensure the correct subitem ID is selected and that the Is Subitem flag is enabled; otherwise, the update will target the main item.
API Rate Limits: Frequent updates may hit Monday.com's rate limits; consider adding delays or batching updates.