Monday.com icon

Monday.com

Interact with Monday.com API
Join our community

Actions26

Overview

This node operation allows you to create updates (comments or messages) on a specific item within Monday.com. It supports adding new updates as standalone messages or as replies to existing updates, enabling threaded conversations. The node can also parse user mentions in the update text, converting @userid formats into proper user tags.

Common scenarios include:

  • Adding status updates or comments to tasks or items in Monday.com boards.
  • Creating threaded discussions by replying to existing updates.
  • Automatically tagging users in updates to notify them.

Practical example:

  • A project manager wants to add a progress note to a task and mention a team member for review: "Hello @12345678, please review this item".
  • A team member replies to an existing update to provide additional information, creating a threaded conversation.

Properties

Name Meaning
Item ID The unique identifier of the item to which the update will be added.
Update Text The content of the update message. Supports multi-line text. Use @userid format to mention users.
Additional Options Optional settings including:
- Parent Update ID: ID of an existing update to reply to (threaded).
Parse User Mentions Boolean flag to enable automatic parsing of @userid mentions in the update text into user tags.

Output

The output JSON contains the response from Monday.com's API representing the created update. This typically includes details such as the update's ID, text content, author, creation time, and any parsed user mentions if enabled.

If user mentions are parsed, the output may also include structured data about these mentions.

No binary data is output by this node operation.

Dependencies

  • Requires an active connection to Monday.com via an API token credential.
  • Uses Monday.com API version defaulting to "2023-10" unless otherwise specified.
  • Relies on Monday.com API client utilities bundled with the node.
  • Optionally uses a utility function to parse user mentions asynchronously by fetching user details from Monday.com.

Troubleshooting

  • Error: Invalid or missing Item ID
    Ensure that the "Item ID" property is correctly set and corresponds to an existing item in Monday.com.

  • Error: Unauthorized or invalid API token
    Verify that the API token credential is valid and has sufficient permissions to add updates.

  • Error: Parsing user mentions failed
    If "Parse User Mentions" is enabled but mentions do not resolve, check that the mentioned user IDs exist and are accessible via the API token.

  • Threaded update creation fails
    When specifying a "Parent Update ID" for replies, ensure the ID is valid and belongs to an update on the same item.

  • General API errors
    Network issues or API rate limits may cause failures; retry or check Monday.com service status.

Links and References

Discussion