Actions42
- getUserByID
- addHumanUser
- listUsers
- setEmail
- resendEmailCode
- verifyEmail
- setPhone
- removePhone
- resendPhoneCode
- verifyPhone
- updateHumanUser
- deactivateUser
- reactivateUser
- lockUser
- unlockUser
- deleteUser
- registerPasskey
- verifyPasskeyRegistration
- createPasskeyRegistrationLink
- listPasskeys
- removePasskey
- registerU2F
- verifyU2FRegistration
- removeU2F
- registerTOTP
- verifyTOTPRegistration
- removeTOTP
- addOTPSMS
- removeOTPSMS
- addOTPEmail
- removeOTPEmail
- startIdentityProviderIntent
- retrieveIdentityProviderIntent
- addIDPLink
- listIDPLinks
- removeIDPLink
- passwordReset
- setPassword
- listAuthenticationMethodTypes
- createInviteCode
- resendInviteCode
- verifyInviteCode
Overview
This node integrates with the Zitadel API to perform various operations across multiple Zitadel services. Specifically, for the addHumanUser operation under the "Default" resource, it allows creating a new human user in the Zitadel system by calling the appropriate service method.
Common scenarios where this node is beneficial include:
- Automating user onboarding workflows by programmatically adding users.
- Integrating Zitadel user management into broader automation pipelines.
- Managing users across different Zitadel services such as UserService or ManagementService.
For example, you can use this node to add a new user with specified username, email, phone, and password details, directly from an n8n workflow without manual intervention.
Properties
| Name | Meaning |
|---|---|
| Service | The Zitadel service to call. Options: UserService, OrganizationService, AuthService, ManagementService, AdminService, ZITADELActions, UserSchemaService. Default is UserService. |
| userId | (UserService only) The unique identifier of the user to add. |
| username | (UserService only) The username for the new human user. |
| organization | (UserService only) The organization to which the user belongs. |
| profile | (UserService and ManagementService) Profile information for the user. |
| (UserService and ManagementService) Email address of the user. | |
| phone | (UserService and ManagementService) Phone number of the user. |
| metadata | (UserService only) Additional metadata associated with the user. |
| password | (UserService only) Password for the user in plain text. |
| hashedPassword | (UserService only) Hashed password for the user. |
| idpLinks | (UserService only) Identity provider links related to the user. |
| totpSecret | (UserService only) TOTP secret for two-factor authentication setup. |
| userName | (ManagementService only) Username for the new human user. |
| initialPassword | (ManagementService only) Initial password for the user. |
Note: Some properties are required depending on the selected service and operation. The node dynamically shows relevant fields based on the chosen service and operation.
Output
The node outputs the response from the Zitadel API call as JSON data. This typically includes the newly created user's details or confirmation of the operation's success.
The output JSON structure depends on the specific service and operation called but generally contains the full response object returned by the Zitadel API method invoked.
No binary data output is produced by this node.
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
- Authentication errors: Ensure that the API token credential is correctly set up and has sufficient permissions.
- Invalid input data: The node expects certain fields to be valid JSON strings or simple strings. If parsing fails, verify the input format.
- Operation not found: Selecting an unsupported operation for the chosen service will result in no action; ensure the correct service-operation combination.
- Network issues: Connectivity problems to the Zitadel API endpoint will cause failures; check network access and endpoint availability.