VendusInstall

Overview

This node integrates with the Vendus API to create a new product category within the user's Vendus account. It is useful for automating the management of product categories in an invoicing and business management system, especially when organizing products into hierarchical groups or updating category metadata programmatically.

Typical use cases include:

• Automatically creating new product categories based on external data sources or workflows.
• Organizing products by categories such as Electronics, Clothing, or custom groupings.
• Setting category status and parent-child relationships to maintain structured product catalogs.

For example, a retailer could use this node to add a new category "Winter Collection" under an existing parent category "Clothing" and mark it as active.

Properties

Output

The node outputs JSON data representing the response from the Vendus API after creating the product category. This typically includes the newly created category's details such as its ID, name, description, status, and parent category information if applicable.

No binary data output is produced by this operation.

Example output snippet (simplified):

{
  "id": "123",
  "title": "Winter Collection",
  "description": "Seasonal clothing category",
  "status": "active",
  "parent_id": "45"
}

Dependencies

• Requires an API key credential configured in n8n to authenticate requests against the Vendus API.
• The node uses the Vendus API base URL provided in the credentials.
• The node depends on the Vendus API endpoints for product categories (/products/categories).

Troubleshooting

• Missing Required Parameters: If the "Category Name" is not provided, the node will throw an error indicating the parameter is required.
• API Authentication Errors: Ensure that the API key credential is correctly set up and has sufficient permissions.
• Parent Category Selection: When specifying a parent category, ensure the selected category exists; otherwise, the API may reject the request.
• Debug Logging: Enabling debug logging can help trace issues by providing detailed logs of the HTTP requests and responses.
• Network Issues: Connectivity problems or incorrect base URL configuration can cause request failures.
• Error Responses: The node surfaces API errors in the output JSON under an error field if "Continue On Fail" is enabled.

Links and References

• Vendus API Documentation (official site linked in node description)
• n8n Expressions Documentation (for using expressions in parameters)
• Vendus product categories endpoint: /products/categories (used internally for loading options and creating categories)