ChatWoot icon

ChatWoot

Interact with ChatWoot API

Actions113

Overview

This node operation allows you to create a new user within a specified account in the system. It is useful for managing team members by assigning them roles such as administrator or agent on an account basis. For example, when onboarding new staff or collaborators, you can programmatically add their user IDs to an account and define their access level.

Properties

Name Meaning
Account Id The numeric identifier of the account where the user will be added.
User Id The unique identifier of the user to be added to the account.
Role The role assigned to the user within the account; options typically include "administrator" or "agent".

Output

The output JSON contains the response from the API after creating the account user. This usually includes details about the newly created account-user association, such as confirmation of the user ID, account ID, assigned role, and possibly metadata like timestamps or status. The node does not output binary data.

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 service to manage accounts and users.

Troubleshooting

  • Common issues:
    • Invalid or missing account ID or user ID may cause the API call to fail.
    • Insufficient permissions or incorrect API credentials can result in authorization errors.
    • Providing an unsupported role value may lead to validation errors.
  • Error messages:
    • "Unauthorized" or "Authentication failed": Check that the API key credential is correctly set up.
    • "Account not found" or "User not found": Verify that the provided IDs exist in the system.
    • "Invalid role": Ensure the role is either "administrator" or "agent".

Links and References

Discussion