Zitadel icon

Zitadel

Interact with the Zitadel API

setPassword

AI-generated

Overview

This node integrates with the Zitadel API to perform various operations across multiple services such as UserService, OrganizationService, AuthService, ManagementService, AdminService, ZITADELActions, and UserSchemaService. Specifically, for the setPassword operation under the UserService resource, it allows updating a user's password by providing the user ID, current password, new password, and a verification code.

Common scenarios where this node is beneficial include:

  • Automating user password resets or updates within an organization's identity management system.
  • Integrating password management workflows into broader automation pipelines.
  • Enforcing password changes triggered by external events or administrative actions.

Practical example:

  • An admin triggers a workflow that calls this node to update a user's password after verifying their identity through a verification code sent via email or SMS.

Properties

Name Meaning
Service Selects which Zitadel service to interact with. Options: UserService, OrganizationService, AuthService, ManagementService, AdminService, ZITADELActions, UserSchemaService. Default is UserService.
userId The unique identifier of the user whose password will be changed. Required for setPassword operation in UserService.
newPassword The new password to set for the user. Required for setPassword operation in UserService.
currentPassword The user's current password, used to authenticate the password change request. Required for setPassword operation in UserService.
verificationCode A code used to verify the password change request, typically sent to the user for confirmation. Required for setPassword operation in UserService.

Output

The node outputs a JSON object representing the response from the Zitadel API for the invoked operation. For the setPassword operation, this typically includes confirmation details about the password update status.

No binary data output is produced by this node.

Example output structure (simplified):

{
  "result": {
    "userId": "string",
    "passwordChanged": true,
    "message": "Password updated successfully"
  }
}

(Note: Actual fields depend on the Zitadel API response.)

Dependencies

  • Requires an API authentication token (Personal Access Token) for Zitadel, configured in n8n credentials.
  • Connects to the Zitadel API endpoint at https://zitadel.studentcouncil.dk.
  • Uses gRPC client libraries internally to communicate with Zitadel services.

Troubleshooting

  • Invalid Credentials or Missing Token: If the API token is missing or invalid, the node will fail to authenticate. Ensure the API key credential is correctly configured in n8n.
  • Incorrect Parameters: Providing incorrect or malformed parameters (e.g., invalid userId, wrong verification code) may cause the API to reject the request. Double-check input values.
  • JSON Parsing Errors: The node attempts to parse inputs as JSON if possible; malformed JSON strings in parameters can cause errors. Provide plain strings for simple fields like passwords.
  • Operation Not Supported: Selecting an operation not supported by the chosen service will result in no action. Verify that the operation matches the selected service.
  • Network Issues: Connectivity problems to the Zitadel API endpoint will cause failures. Check network access and endpoint availability.

Links and References

Discussion