Zorus icon

Zorus

Interact with Zorus API

Actions13

Overview

This node integrates with the Zorus API to manage groups within a customer context. Specifically, the "Create Group" operation allows users to create a new group associated with a particular customer and optionally link it to a base policy. This is useful in scenarios where organizational structures or access controls need to be programmatically managed, such as setting up user groups for permissions or policy enforcement in an enterprise environment.

Practical examples include:

  • Automating the creation of user groups when onboarding new customers.
  • Structuring groups based on predefined policies to streamline access management.
  • Integrating group creation into larger workflows that provision resources or configure environments dynamically.

Properties

Name Meaning
Customer UUID The unique identifier (UUID) of the customer for whom the group is being created.
Name The name assigned to the new group.
Base Policy UUID The unique identifier (UUID) of the base policy to associate with the group (optional).

Output

The node outputs JSON data representing the newly created group as returned by the Zorus API. This typically includes details such as the group's UUID, name, associated customer UUID, linked base policy UUID (if any), and other metadata provided by the API.

If the node supports binary data output, it would generally relate to attachments or files associated with the group, but this operation primarily deals with JSON data.

Dependencies

  • Requires an active connection to the Zorus API endpoint at https://developer.zorustech.com/api.
  • Needs an API authentication token credential configured in n8n to authorize requests.
  • The node expects the API version header "Zorus-Api-Version": "1.0" to be set for compatibility.

Troubleshooting

  • Missing or invalid Customer UUID: The API will reject requests if the customer UUID is not provided or incorrect. Ensure the UUID is valid and corresponds to an existing customer.
  • Group name conflicts: If a group with the same name already exists under the customer, the API might return an error. Use unique names or handle duplicates accordingly.
  • Invalid Base Policy UUID: Providing a non-existent or unauthorized base policy UUID may cause the request to fail. Verify the policy UUID before use.
  • Authentication errors: Ensure the API key credential is correctly configured and has sufficient permissions.
  • Network issues: Connectivity problems to the Zorus API endpoint can cause timeouts or failures; verify network access and proxy settings if applicable.

Links and References

Discussion