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 in applications that use Zitadel for identity and access management.
• Resetting user passwords programmatically without manual intervention.
• Integrating password reset functionality into custom automation or workflow pipelines.

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.

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 typically include details about the password reset request status or any relevant metadata returned by the API.

No binary data output is indicated in the source code.

Example output structure (simplified):

{
  "json": {
    // Response fields from Zitadel's password reset API call
  }
}

Dependencies

• Requires an API authentication token (Personal Access Token) for Zitadel, which must be provided via node credentials.
• Connects to the Zitadel API endpoint at https://zitadel.studentcouncil.dk.
• Uses gRPC client libraries to communicate with Zitadel services.
• No additional environment variables are explicitly required beyond the API credential.

Troubleshooting

• Invalid Credentials: If the API token is missing or invalid, the node will fail to authenticate. Ensure the correct API key/token is configured in the node credentials.
• Incorrect Parameters: Missing or malformed parameters like userId, sendLink, or returnCode can cause errors. Verify all required inputs are correctly set.
• JSON Parsing Errors: The node attempts to parse input parameters as JSON if possible. Providing invalid JSON strings may cause parsing failures. Use plain strings where appropriate.
• Unsupported Operation: If an operation name is misspelled or not supported by the selected service, the node returns an empty JSON object. Double-check the operation and service names.
• Network Issues: Connectivity problems to the Zitadel API endpoint will prevent successful execution.

Links and References

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