Actions99
- Group Accounts Actions
- Group Account Codes Actions
- Accounts Actions
- Expenses Actions
- Purchase Orders Actions
- Get A List Of Purchase Orders
- Create A New Purchase Order
- Get A Purchase Order
- Update A Purchase Order
- Open A Purchase Order
- Get A List Of Purchase Orders Items For A Specific Purchase Order
- Create A Purchase Order Item
- Get A Purchase Order Item
- Update A Purchase Order Item
- Delete A Purchase Order Item
- Get A List Of Goods Received Notes For A Specific Purchase Order
- Create A Goods Received Note
- Attach A File To A Goods Received Note
- Delete A Goods Received Note
- Suppliers Actions
- Fund Accounts Actions
- Cards Actions
- Expense Categories Actions
- Tax Rates Actions
- Amortizations Actions
- Account Teams Actions
- Account Codes Actions
- External Teams Actions
- Custom Fields Actions
- Get Custom Fields
- Create A New Custom Field
- Get Custom Field
- Update Custom Field
- Delete A Custom Field And All Its Values
- Get Custom Field Values
- Create A Custom Field Value
- Delete Custom Field Values
- Get A Custom Field Value
- Update A Custom Field Value
- Delete A Custom Field Value
- Get Managers For A Specific Custom Field Value
- Adds Managers For A Specific Custom Field Value
- Replaces Managers For A Specific Custom Field Value
- Removes Managers For A Specific Custom Field Value
- Webhook Subscriptions Actions
- Group Teams Actions
Accounts → Update Account User
AI-generatedOverview
This node operation updates a user's role and optionally their external identifier within a specified account. It is useful in scenarios where user permissions or roles need to be changed dynamically, such as promoting an employee to an admin role or adjusting access levels based on organizational changes. For example, if a company wants to change a user's role from "Employee" to "Accounting" to grant them access to financial data, this node operation facilitates that update seamlessly.
Properties
| Name | Meaning |
|---|---|
| Account Id | Identifier of the account where 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 an external system (optional). |
Output
The node outputs JSON data representing the updated user information within the account. This typically includes confirmation of the updated fields such as the new role and any external ID set. The output structure reflects the API response confirming the successful update of the user details.
No binary data output is involved in this operation.
Dependencies
- Requires an API key credential for authenticating requests to the external service managing accounts and users.
- The base URL for the API must be configured in the node credentials.
- The node depends on the external service's REST API to perform the update operation.
Troubleshooting
- Common Issues:
- Invalid or missing Account Id or User Id will cause the update to fail.
- Insufficient permissions associated with the API key may prevent role updates.
- Providing an invalid role value outside the allowed options will result in an error.
- Error Messages:
- "User not found" indicates the provided User Id does not exist in the specified account.
- "Account not found" means the Account Id is incorrect or inaccessible.
- "Unauthorized" suggests issues with API authentication; verify the API key and permissions.
- Resolutions:
- Double-check the Account Id and User Id values for correctness.
- Ensure the API key has sufficient privileges to update user roles.
- Use one of the predefined role options: Admin, Accounting, or Employee.
Links and References
- Refer to the external service’s API documentation for detailed information on user management endpoints.
- n8n documentation on how to configure API credentials and use HTTP request nodes for custom integrations.