ImmyBot icon

ImmyBot

ImmyBot Node

Overview

The node provides functionality to create a new tag within the ImmyBot system. Tags are useful for categorizing, labeling, or grouping items, making it easier to organize and filter data. This operation is beneficial in scenarios where users want to add metadata to entities dynamically, such as marking tasks with priority levels, categorizing content by topic, or assigning color-coded labels for visual management.

For example, a user might create a tag named "Urgent" with a red color to highlight high-priority items, or a tag called "Review" with a blue color to mark items that need further inspection.

Properties

Name Meaning
Name The name of the tag to be created. This is a required string input.
Description An optional description providing more details about the tag's purpose or usage.
Color The color assigned to the tag for visual identification. Options include: Black, Blue, Danger (red), Orange, Primary (default), Purple, Secondary (gray), Success (green), Warning (yellow).

Output

The node outputs JSON data representing the newly created tag object. This typically includes fields such as the tag's unique identifier, name, description, color, and possibly timestamps or metadata related to creation. The output allows subsequent nodes in the workflow to reference or manipulate the created tag.

There is no indication that this node outputs binary data.

Dependencies

  • Requires an API key credential for authentication with the ImmyBot service.
  • The node uses the ImmyBot API endpoint constructed from the user's subdomain.
  • Proper configuration of the API credentials and subdomain is necessary for successful requests.

Troubleshooting

  • Authentication errors: Ensure that the API key credential is correctly configured and has sufficient permissions.
  • Invalid input: The "Name" property is required; omitting it will likely cause an error.
  • Color option mismatch: Selecting a color outside the provided options may result in request failure.
  • Network issues: Verify connectivity to the ImmyBot API endpoint and correct subdomain configuration.
  • API errors: If the API returns an error, check the response message for details such as duplicate tag names or invalid parameters.

Links and References

Discussion