Worktables

Interact with Monday.com boards and items

Actions30

Overview

The Worktables node for n8n enables interaction with Monday.com boards, items, and updates.
For the resource Update and operation List, this node retrieves all updates (comments, notes, or discussions) associated with a specific item on a Monday.com board.

Common scenarios:

Fetching all communication history or change logs attached to a task/item.
Integrating Monday.com update streams into reporting, notifications, or archiving workflows.
Monitoring collaboration or progress on a particular item.

Example use cases:

Automatically collect all updates for a task and send them in a summary email.
Archive all updates from completed items to an external database.
Trigger downstream actions when new updates are detected on an item.

Properties

Below are the input properties relevant for the Update → List operation:

Display Name	Type	Description
Workspace	options	Select a workspace. Choose from the list, or specify an ID using an expression. (Required)
Board	options	Select a Monday board. Choose from the list, or specify an ID using an expression. (Required)
Item	options	Select an item from the selected board. Choose from the list, or specify an ID using an expression. (Required)

Output

The output is a JSON array where each element represents an update associated with the specified item. Each update object contains:

{
  "id": "string",              // Unique identifier of the update
  "text_body": "string",       // The main text/content of the update
  "created_at": "string",      // Creation timestamp (ISO format)
  "updated_at": "string",      // Last updated timestamp (ISO format)
  "creator": {
    "id": "string",            // Creator's user ID
    "name": "string"           // Creator's name
  },
  "assets": [
    {
      "name": "string",        // Name of the attached file
      "public_url": "string",  // Public URL to access the file
      "file_size": number      // Size of the file in bytes
    }
    // ...more assets
  ],
  "replies": [
    {
      "text_body": "string",   // Text content of the reply
      "created_at": "string",  // Reply creation timestamp
      "creator": {
        "name": "string"       // Name of the reply creator
      }
    }
    // ...more replies
  ],
  "pinned_to_top": {
    "item_id": "string"        // If pinned, the item ID it is pinned to
  }
}

The output is always in JSON format; no binary data is produced by this operation.

Dependencies

External Service: Requires a valid Monday.com account and API key.
n8n Credentials: You must configure credentials of type WorktablesApi in n8n, which should include your Monday.com API key.
Environment: No special environment variables required beyond standard n8n setup.

Troubleshooting

Common issues:

Missing API Key:
Error message: API Key not found
Resolution: Ensure that the WorktablesApi credential is set up correctly in n8n and contains a valid Monday.com API key.
Missing Required Fields:
Error message: Board ID is required. or Item ID is required.
Resolution: Make sure you have selected both a board and an item before running the node.
No Updates Returned:
If the item has no updates, the output will be an empty array. This is expected behavior.
Invalid IDs:
If you provide an invalid workspace, board, or item ID, the node may return an error or an empty result. Double-check the IDs or use the dropdown selectors.