ChatWootInstall

Overview

This node operation allows you to create a new user within a specific account in the system. It is useful for managing team members by assigning them roles such as administrator or agent on an account basis. Typical use cases include onboarding new users to an account, setting their permissions, and integrating user management into automated workflows.

For example, when a new employee joins a company, this node can be used to add them as an agent or administrator to the company's account automatically.

Properties

Output

The output JSON contains the response from the API after creating the account user. This typically includes details about the newly created account-user relationship, such as confirmation of the user being added, their assigned role, and any metadata returned by the service.

No binary data output is expected from this operation.

Dependencies

• Requires an API key credential for authenticating with the ChatWoot API.
• The base URL for the API must be configured in the node credentials.
• The node depends on the external ChatWoot API service to perform the user creation.

Troubleshooting

• Common issues:

  • Invalid or missing Account Id or User Id may cause the API call to fail.
  • Insufficient permissions for the API key could result in authorization errors.
  • Providing an invalid role value (anything other than "administrator" or "agent") might cause the request to be rejected.

• Error messages:

  • "Unauthorized" or "Authentication failed": Check that the API key credential is correctly set up and has necessary permissions.
  • "Invalid account ID" or "User not found": Verify that the provided Account Id and User Id exist and are correct.
  • "Role is invalid": Ensure the role property is either "administrator" or "agent".

Links and References

• ChatWoot API Documentation (for detailed API usage and role definitions)
• n8n documentation on creating custom nodes