Worktables

Interact with Monday.com boards and items

Actions29

Overview

This node interacts with Monday.com boards and items, specifically allowing you to update column values of an existing item on a board. It is useful for automating updates to project management data stored in Monday.com, such as changing task statuses, updating due dates, or modifying any custom column values programmatically.

A practical example: You have an automation that triggers when a support ticket is updated in another system, and you want to reflect the new status or priority in the corresponding Monday.com item by updating its columns automatically.

Properties

Name	Meaning
Workspace Name or ID	Select the workspace containing the board. Choose from the list or specify an ID using an expression.
Board Name or ID	Select the Monday.com board where the item exists. Choose from the list or specify an ID using an expression.
Item Name or ID	Select the item on the board to update. Choose from the list or specify an ID using an expression.
Is Subitem	Boolean flag indicating whether the target item is a subitem (a child item). If true, additional options for subitems become available.
Subitem Name Or Name or ID	If "Is Subitem" is true, select the specific subitem to update. Choose from the list or specify an ID using an expression.
Column Values	A collection of one or more column updates. Each entry requires: - Column Name or ID: The column to update, selectable from the board's columns. - New Value: The new value to set for that column, as a string.

Output

The output JSON contains the response from the Monday.com API after attempting to update the item’s column values. Typically, this includes the updated item's ID confirming the mutation was successful.

Example structure:

{
  "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 (referred generically as an API authentication token).
The node makes HTTP POST requests to the Monday.com GraphQL API endpoint at https://api.monday.com/v2.
Proper permissions on the API token are necessary to update items on the specified board.

Troubleshooting

API Key Not Found: The node will throw an error if the API key credential is missing or invalid. Ensure the API key is correctly configured in n8n credentials.
Missing Required Parameters: Errors occur if required parameters like Board ID or Item ID are not provided. Always ensure these fields are filled or dynamically set via expressions.
Invalid Column Values Format: The column values must be formatted as a JSON object string mapping column IDs to their new values. Incorrect formatting can cause API errors.
Subitem Handling: When updating a subitem, the node first fetches the subitem’s board ID before performing the update. If the subitem ID is incorrect or does not exist, the operation will fail.
API Rate Limits or Permissions: If the API token lacks permission to modify the board or item, or if rate limits are exceeded, the API will return errors. Check token scopes and usage limits.