ImmyBotInstall

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 when you want to programmatically add metadata tags to entities managed by ImmyBot, such as tasks, messages, or other resources.

For example, you might use this node to create a "Priority" tag with a red color to mark urgent items, or a "Follow-up" tag with a blue color to indicate items that require further attention.

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.
Color	The color assigned to the tag. 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 the tag's unique identifier, name, description, color, and any other metadata returned by the ImmyBot API. The output can be used downstream in workflows to reference or manipulate the created tag.

No binary data output is involved in this operation.

Dependencies

• Requires an API authentication token configured via OAuth2 credentials to connect securely to the ImmyBot API.
• The node uses the base URL constructed from the user's subdomain in ImmyBot.
• Proper permissions on the API key or OAuth2 token are necessary to create tags.

Troubleshooting

• Authentication errors: Ensure the OAuth2 credentials are correctly set up and have not expired.
• Validation errors: The "Name" property is required; missing or empty names will cause the API to reject the request.
• Color option invalid: Only the predefined color options are accepted; using unsupported values may result in errors.
• API connectivity issues: Verify network access to the ImmyBot API endpoint and correct subdomain configuration.

Links and References

• ImmyBot official API documentation (for tags): ImmyBot API Docs
• OAuth2 setup guide for ImmyBot integration in n8n (refer to n8n docs)