ZitadelInstall

Overview

This node integrates with the Zitadel API, allowing users to perform various operations across multiple Zitadel services such as UserService, OrganizationService, AuthService, ManagementService, AdminService, ZITADELActions, and UserSchemaService. Specifically, for the passwordReset operation under the UserService resource, it facilitates triggering a password reset process for a user by providing necessary parameters like user ID, whether to send a reset link, and a return code.

Common scenarios where this node is beneficial include:

• Automating user management workflows, such as resetting passwords programmatically.
• Integrating Zitadel's identity and access management features into custom automation pipelines.
• Managing organizational users and authentication flows without manual intervention.

Practical example:

• A workflow that detects suspicious login activity could automatically trigger a password reset for the affected user by calling this node with the passwordReset operation, specifying the user's ID and whether to send a reset link.

Properties

Output

The node outputs a JSON object containing the response from the Zitadel API corresponding to the invoked operation. For the passwordReset operation, the output JSON will contain details about the password reset request result as returned by the Zitadel UserService.

No binary data output is produced by this node.

Dependencies

• Requires an API authentication token (Personal Access Token) for Zitadel, which must be configured in the node credentials.
• Connects to the Zitadel API endpoint at https://zitadel.studentcouncil.dk.
• Uses gRPC clients generated from Zitadel protobuf definitions to communicate with the API.

Troubleshooting

• Invalid or missing API token: Ensure the Zitadel API token is correctly set in the node credentials; otherwise, authorization errors will occur.
• Incorrect property values: For example, if userId, sendLink, or returnCode are missing or malformed, the API call may fail. Verify these inputs are correctly provided.
• Operation not supported: If an unsupported operation is selected for a given service, the node returns an empty JSON object. Confirm the operation is valid for the chosen service.
• JSON parsing errors: Input properties are parsed as JSON if possible. Malformed JSON strings in input fields can cause errors. Provide valid JSON or plain strings accordingly.

Links and References

• Zitadel Official Documentation
• Zitadel API Reference
• n8n Documentation on Creating Custom Nodes