Worktables icon

Worktables

Interact with Monday.com boards and items

Actions26

Overview

This node allows you to create updates on Monday.com items. Specifically, the "Update" resource with the "Create" operation lets you add a new update (a comment or note) to an existing item on a Monday.com board. You can also create replies to existing updates.

Common scenarios where this node is useful include:

  • Adding status updates or comments to tasks or projects tracked in Monday.com.
  • Collaborating by posting notes or feedback directly on specific items.
  • Automating communication workflows by programmatically adding updates based on external triggers.

For example, you could use this node to automatically post a progress update to a task item whenever a related event occurs in another system.

Properties

Name Meaning
Workspace Name or ID Select the workspace containing the board.
Board Name or ID Select the Monday.com board that contains the item to update.
Item Name or ID Select the specific item on the board to which the update will be added.
Body Content The text content of the update to create.
Is Reply Boolean flag indicating whether the update is a reply to an existing update (true) or a new update (false).
Update ID To Reply If creating a reply, specify the ID of the update to which this is replying.

Output

The output JSON contains the response from the Monday.com API after creating the update. It includes at least the id of the newly created update, confirming successful creation.

Example output structure:

{
  "data": {
    "create_update": {
      "id": "123456789"
    }
  }
}

No binary data 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: https://api.monday.com/v2.
  • Proper permissions on the Monday.com account are needed to create updates on items.

Troubleshooting

  • API Key Not Found: The node throws an error if the API key credential is missing or invalid. Ensure the API key is correctly configured in n8n credentials.
  • Invalid Item or Board IDs: Errors occur if the specified workspace, board, or item IDs do not exist or are inaccessible. Verify these IDs are correct and accessible by the API key.
  • Empty Body Content: Providing empty body content may cause the API to reject the request. Always provide meaningful text for the update.
  • Reply Without Update ID: If "Is Reply" is true but no "Update ID To Reply" is provided, the mutation will fail. Make sure to specify the parent update ID when creating replies.

Links and References

Discussion