Payhawk icon

Payhawk

Interact with the Zitadel API

Actions99

Overview

This node operation updates a user's role and external identifier within a specified account. It is useful in scenarios where user permissions or identifiers need to be changed dynamically, such as managing team roles in an accounting system or adjusting access levels for employees. For example, you might use this node to promote a user to an admin role or update their external system ID after a synchronization.

Properties

Name Meaning
Account Id Identifier of the account to which the user belongs.
User Id Identifier of the user whose details are being updated.
Role New role assigned to the user. Options: Admin, Accounting, Employee.
External Id Unique identifier of the account user in the external system (optional).

Output

The node outputs JSON data representing the updated user information within the account. This typically includes confirmation of the changes made, such as the new role and external ID values. The output does not include binary data.

Dependencies

  • Requires an API key credential for authentication with the external service.
  • The node uses a base URL configured in the credentials to send requests.
  • The external service must support updating account users via its API.

Troubleshooting

  • Missing Required Fields: Ensure that both Account Id and User Id are provided; otherwise, the request will fail.
  • Invalid Role Value: Only "admin", "accounting", or "employee" are accepted. Using other values may cause errors.
  • Authentication Errors: Verify that the API key credential is correctly set up and has sufficient permissions.
  • API Endpoint Issues: Confirm that the base URL in credentials is correct and the external service is reachable.
  • External Id Conflicts: If the externalId is already used by another user, the update might be rejected.

Links and References

  • Refer to the external service's API documentation for detailed information on user role management and account user updates.
  • n8n documentation on creating and using custom nodes: https://docs.n8n.io/creating-nodes/

Discussion