AvantGuard - ConnectSecure icon

AvantGuard - ConnectSecure

AvantGuard - ConnectSecure

Actions223

Overview

This node operation allows you to create a new tag by sending a POST request to the target API. It is useful in scenarios where you want to programmatically add tags to categorize or label resources within an external system that supports tagging via its API. For example, you might use this node to automatically tag user accounts, tickets, or assets based on certain criteria in your workflow.

Properties

Name Meaning
X USER ID The User Id header value required for authentication or identification in the API call.
Additional Body Fields Optional additional fields to include in the request body. Currently supports:
- Data: A JSON object with extra data to send in the body of the POST request.

Output

The node outputs the JSON response returned from the API after creating the tag. This typically includes details about the newly created tag such as its ID, name, and any other metadata provided by the API. There is no indication that binary data is handled or output by this node.

Dependencies

  • Requires an API key credential (or similar) configured in n8n to authenticate requests.
  • Depends on the base URL and headers set in the node credentials for connecting to the external service.
  • Uses the @avantguardllc/n8n-openapi-node package internally to build properties and handle requests based on an OpenAPI specification.

Troubleshooting

  • Missing or invalid X USER ID: Since the X USER ID header is required, omitting it or providing an incorrect value will likely cause authentication or authorization errors.
  • Malformed JSON in Additional Body Fields: The data field expects valid JSON. Invalid JSON syntax will cause parsing errors before the request is sent.
  • API connectivity issues: Ensure the base URL and credentials are correctly configured and the external API is reachable.
  • Unexpected API errors: Check the API response message for details; common issues include permission denied, rate limiting, or invalid request format.

Links and References

  • No direct links available from the source code.
  • Refer to the external API documentation for the "Tags" resource and "Create Tag" operation for detailed information on accepted fields and responses.

Discussion