Worktables icon

Worktables

Interact with Monday.com boards and items
Join our community

Actions126

Overview

This node operation creates an update on a specified item within a Monday.com board. It supports creating a new update or a reply to an existing update, optionally pinning the update to the top of the item. Users can include body content, mention users, teams, or boards, and attach binary files to the update. This is useful for adding comments, progress notes, or discussions related to a specific item in project management workflows.

Use Case Examples

  1. Create a new update on a project task item to provide status updates.
  2. Reply to an existing update to continue a discussion thread on an item.
  3. Pin an important update to the top of an item for visibility.
  4. Mention specific team members or boards in an update to notify them directly.

Properties

Name Meaning
Item The ID of the item on the selected board where the update will be created. This is required to specify the target item for the update.
Body Content The textual content of the update to be created. This is the main message or comment body of the update.
Is Reply Boolean flag indicating whether the update is a reply to an existing update. If true, the update will be nested as a reply.
Pin Update to Top Boolean flag to pin the created update to the top of the item. Only applicable when creating a new top-level update (not a reply).
Mentions List (Users, Teams, Boards) A collection of entities (users, teams, or boards) to mention in the update. Each mention includes the type and the ID of the entity to notify.
Attachments (Binary Properties) Comma-separated names of binary properties containing files to attach to the update. These files will be uploaded and linked to the update.
Update ID To Reply The ID of the update to which this new update is a reply. Required if 'Is Reply' is true.

Output

JSON

  • id - The unique identifier of the created update.
  • text_body - The body content of the created update.
  • created_at - Timestamp when the update was created.
  • updated_at - Timestamp when the update was last updated.
  • creator
    • id - ID of the user who created the update.
    • name - Name of the user who created the update.
  • assets - List of attached files with their names, URLs, and sizes.
  • replies - List of replies to the update, each with text, creation time, and creator name.
  • pinned_to_top - Indicates if the update is pinned to the top of the item.

Dependencies

  • Monday.com API
  • API key credential for authentication

Troubleshooting

  • Ensure the API key credential is correctly configured and has permissions to create updates on the specified board and item.
  • Verify that the item ID and update ID (if replying) are valid and exist in the selected board.
  • If attaching files, confirm that the binary property names are correct and the files are accessible.
  • Check for API rate limits or errors returned by Monday.com and handle them appropriately in the workflow.

Links

Discussion