Worktables icon

Worktables

Interact with Monday.com boards and items

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 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 message to a task when a related event occurs in another system, or to reply to an existing update to continue a discussion thread.

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 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.
Update ID To Reply If creating a reply, specify the ID of the update to reply to.

Output

The output JSON contains the response from the Monday.com API after creating the update. It typically includes the newly created update's ID, confirming successful creation.

Example output structure:

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

No binary data is output by this operation.

Dependencies

  • Requires an API key credential for Monday.com with appropriate permissions to create updates on items.
  • 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 throws an error if the API key credential is missing or invalid. Ensure the API key is correctly configured and has sufficient permissions.
  • Missing Required Parameters: Errors occur if required fields like workspace, board, or item IDs are not provided. Double-check that these inputs are set.
  • Invalid Update ID for Reply: When creating a reply, specifying a non-existent or incorrect update ID will cause failure. Verify the update ID is valid.
  • GraphQL Errors: Any syntax or permission errors returned by the Monday.com API will be surfaced. Review the error messages for details and adjust inputs accordingly.

Links and References

Discussion