Monday.comInstall

Overview

This node operation processes a text string containing user mentions formatted as @userid and generates structured mention data compatible with Monday.com updates. It parses the input text to identify user mentions, resolves them to user objects via the Monday.com API, and returns both the original and formatted text along with details about the mentions.

This is useful when you want to programmatically create or manipulate update messages on Monday.com that include user mentions, ensuring the mentions are correctly recognized and linked to actual users in Monday.com.

Practical examples:

• Automatically generating update messages that mention specific users by their IDs.
• Parsing user-generated text to extract and format mentions before posting updates.
• Validating and formatting mentions in update comments or replies.

Properties

Output

The output JSON object contains the following fields:

• originalText: The original input text as provided.
• formattedText: The text after parsing and formatting user mentions into Monday.com's expected mention syntax.
• mentions: An array of mention objects representing each parsed user mention. Each mention includes user details resolved from Monday.com.
• mentionsCount: The total number of mentions found in the input text.

This structured output allows subsequent nodes or workflows to use the formatted text and mention metadata for creating or updating Monday.com updates with proper user mentions.

Dependencies

• Requires an active connection to Monday.com via an API token credential.
• Uses Monday.com API to resolve user IDs mentioned in the text.
• The node depends on a utility function to parse user mentions asynchronously by querying Monday.com users.

Troubleshooting

• Common issues:

  • Invalid or non-existent user IDs in the mention text will result in missing or incomplete mention data.
  • Network or authentication errors connecting to Monday.com API can cause failures.
  • Malformed input text without proper @userid format may yield zero mentions.

• Error messages:

  • Errors related to user resolution (e.g., "User with ID X not found") indicate invalid user IDs.
  • Authentication errors suggest checking the configured API token credential.
  • JSON parsing errors are unlikely here since input is plain text, but malformed internal data could cause issues.

• Resolutions:

  • Verify that all user IDs in the text exist in Monday.com.
  • Ensure the API token credential is valid and has sufficient permissions.
  • Confirm the input text follows the expected mention format (@userid).

Links and References

• Monday.com API Documentation
• Monday.com User Mentions Guide