Worktables

Interact with Monday.com boards and items

Actions26

Overview

The node "Worktables" integrates with Monday.com to interact with various resources such as boards, items, updates, teams, users, and queries. Specifically for the Update resource with the List operation, it retrieves all updates associated with a specified item on a Monday.com board.

This node is beneficial when you want to programmatically fetch updates (comments, status changes, attachments, etc.) related to an item in Monday.com for further processing, reporting, or automation workflows. For example, you could use this node to gather all communication threads on a task item and send a summary email or trigger notifications based on update content.

Properties

Name	Meaning
Workspace Name or ID	Select the workspace containing the board. Choose from the list or specify an ID via expression.
Board Name or ID	Select the Monday board containing the item. Choose from the list or specify an ID via expression.
Item Name or ID	Select the specific item on the board whose updates you want to list. Choose from the list or specify an ID via expression.

These properties are required to identify the context (workspace, board, and item) from which updates will be listed.

Output

The output JSON contains the list of updates for the specified item. Each update includes:

id: The unique identifier of the update.
text_body: The textual content of the update.
created_at: Timestamp when the update was created.
updated_at: Timestamp when the update was last modified.
creator: Object with creator details (id and name).
assets: Array of attached files/assets with fields like name, public_url, and file_size.
replies: Array of replies to the update, each with text_body, created_at, and creator's name.
pinned_to_top: Information if the update is pinned, including the item_id.

This rich structure allows detailed inspection of all communications and attachments related to an item.

Dependencies

Requires an API key credential for Monday.com (referred generically as "an API key credential").
The node makes HTTP POST requests to the Monday.com GraphQL API endpoint: https://api.monday.com/v2.
Proper permissions on the Monday.com account to read updates on items.

Troubleshooting

API Key Not Found: If the API key credential is missing or invalid, the node throws an error. Ensure the API key is correctly configured in n8n credentials.
Invalid Item ID: If the specified item ID does not exist or is incorrect, the query will return empty or error responses. Verify the item ID is correct and accessible.
Permission Issues: Insufficient permissions on the Monday.com account may cause errors or incomplete data. Confirm the API key has read access to the workspace, board, and item.
Rate Limits: Monday.com API rate limits might affect large queries. Consider limiting the number of items or implementing retries.

Links and References

If you need details about other operations or resources, feel free to ask!