Actions113
- Accounts Actions
- Account Users Actions
- Agent Bots Actions
- Users Actions
- Inbox API Actions
- Contacts API Actions
- Conversations API Actions
- Messages API Actions
- CSAT Survey Page Actions
- Account Agent Bots Actions
- Agents Actions
- Canned Responses Actions
- Canned Response Actions
- Custom Attributes Actions
- Contacts Actions
- Contact Actions
- Automation Rule Actions
- Help Center Actions
- Conversations Actions
- Conversation Assignment Actions
- Conversation Labels Actions
- Inboxes Actions
- Messages Actions
- Integrations Actions
- Teams Actions
- Custom Filters Actions
- Webhooks Actions
- Reports Actions
Overview
This node allows you to create a new contact in the ChatWoot system. It is useful for automating the addition of contacts into your ChatWoot account, such as when integrating with CRM systems, lead capture forms, or customer support platforms. For example, when a new user signs up on your website, this node can automatically add their details as a contact in ChatWoot, enabling seamless communication and tracking.
Properties
| Name | Meaning |
|---|---|
| Account Id | The numeric ID of the ChatWoot account where the contact will be created (required). |
| Inbox Id | The numeric ID of the inbox within the account to associate the contact with (required). |
| Name | The name of the contact. |
| The email address of the contact. | |
| Phone Number | The phone number of the contact. |
| Avatar | Binary data representing the avatar image of the contact. |
| Avatar Url | URL pointing to an image file (jpeg, png) to use as the contact's avatar. |
| Identifier | A unique identifier for the contact in an external system, useful for synchronization. |
| Custom Attributes | A JSON object containing custom key-value pairs to store additional attributes about contact. |
Output
The node outputs JSON data representing the newly created contact as returned by the ChatWoot API. This typically includes the contact's ID, associated account and inbox IDs, name, email, phone number, avatar information, identifier, and any custom attributes set. If an avatar image is provided as binary data, it is sent as part of the request but not outputted separately.
Dependencies
- Requires an active ChatWoot account with API access.
- Needs an API authentication token configured in n8n credentials to authorize requests.
- The base URL of the ChatWoot instance must be set in the credentials configuration.
Troubleshooting
- Missing required fields: Ensure that both Account Id and Inbox Id are provided; these are mandatory.
- Invalid API credentials: Authentication errors indicate incorrect or missing API tokens.
- Avatar upload issues: When sending avatar images, ensure the binary data is correctly formatted and the file type is supported.
- Custom attributes format: The custom attributes field must be valid JSON; invalid JSON will cause parsing errors.
- Network or API errors: Check connectivity to the ChatWoot instance and verify the API endpoint URL.