ChatWoot

Interact with ChatWoot API

Actions113

Accounts Actions
- Create An Account
- Get Details Of An Account
- Delete An Account
- Update An Account
Account Users Actions
- List All Account Users
- Create An Account User
- Delete An Account User
Agent Bots Actions
- Create An Agent Bot
- Get Details Of A Single Agent Bot
- Delete An Agent Bot
- Update An Agent Bot
Users Actions
- Create A User
- Get Details Of A User
- Delete A User
- Update A User
- Get Sso Url Of A User
Inbox API Actions
- Get Details Of A Inbox
Contacts API Actions
- Create A Contact
- Get Details Of A Contact
- Update A Contact
Conversations API Actions
- List All Contact Conversations
- Create A Conversation
Messages API Actions
- List All Converation Messages
- Create A Message
- Update A Message
CSAT Survey Page Actions
- Get Csat Survey Page
Account Agent Bots Actions
- List All Account Agent Bots
- Create An Account Agent Bot
- Get Details Of A Single Account Agent Bot
- Delete An Account Agent Bot
- Update An Account Agent Bot
Agents Actions
- Get Account Agents
- Add New Agent To Account
- Delete Agent From Account
- Update Agent In Account
Canned Responses Actions
- Get Account Canned Response
- Add New Canned Response To Account
- Delete Canned Response From Account
Canned Response Actions
- Update Canned Response In Account
Custom Attributes Actions
- Get Account Custom Attribute
- Add New Custom Attribute To Account
- Get Details Of A Single Custom Attribute
- Delete Custom Attribute From Account
- Update Custom Attribute In Account
Contacts Actions
- Contact List
- Contact Create
- Contact Details
- Contact Update
- Contact Delete
- Contact Conversations
- Contact Search
- Contact Filter
Contact Actions
- Contact Inbox Creation
- Contactable Inboxes Get
Automation Rule Actions
- Get Account Automation Rule
- Add New Automation Rule To Account
- Get Details Of A Single Automation Rule
- Delete Automation Rule From Account
- Update Automation Rule In Account
Help Center Actions
- Get Portal
- Add New Portal To Account
- Update New Portal To Account
- Add New Category To Account
- Add New Article To Account
Conversations Actions
- Conversation List Meta
- Conversation List
- New Conversation
- Conversation Filter
- Get Details Of A Conversation
- Toggle Status Of A Conversation
- Toggle Priority Of A Conversation
Conversation Assignment Actions
- Assign A Conversation
Conversation Labels Actions
- List All Labels Of A Conversation
- Conversation Add Labels
Inboxes Actions
- List All Inboxes
- Get Inbox
- Inbox Creation
- Update Inbox
- Get Inbox Agent Bot
- Update Agent Bot
- Get Inbox Members
- Add New Agent To Inbox
- Delete Agent In Inbox
- Update Agents In Inbox
Messages Actions
- List All Messages
- Create A New Message In A Conversation
- Delete A Message
Integrations Actions
- Get Details Of All Integrations
- Create An Integration Hook
- Delete An Integration Hook
- Update An Integrations Hook
Teams Actions
- List All Teams
- Create A Team
- Get Details Of A Single Team
- Delete A Team
- Update A Team
- Get Team Members
- Add New Agent To Team
- Delete Agent In Team
- Update Agents In Team
Custom Filters Actions
- List All Filters
- Create A Custom Filter
- Get Details Of A Single Custom Filter
- Delete A Custom Filter
- Update A Custom Filter
Webhooks Actions
- List All Webhooks
- Create A Webhook
- Delete A Webhook
- Update A Webhook
Reports Actions
- List All Conversation Statistics
- List All Conversation Statistics Summary
- Get Account Conversation Metrics
- Get Agent Conversation Metrics

Inboxes → Update Inbox

AI-generated

Overview

This node updates an existing inbox in a ChatWoot account. It is useful for managing communication channels by modifying inbox details such as the name, avatar image, auto-assignment settings, and channel configuration. Typical use cases include renaming an inbox to reflect new team structures, changing the avatar to match branding updates, enabling or disabling automatic assignment of conversations, or updating channel-specific settings.

For example, a customer support manager might use this node to rename an inbox from "Support Team A" to "Priority Support" and enable auto-assignment to ensure incoming messages are distributed automatically among agents.

Properties

Name	Meaning
Account Id	The numeric ID of the ChatWoot account where the inbox exists.
Id	The unique numeric ID of the inbox to update.
Name	The new name for the inbox.
Enable Auto Assignment	Boolean flag to enable or disable automatic assignment of conversations to agents.
Avatar	URL or path to an image file to set as the inbox avatar.
Channel	JSON object representing channel-specific configuration details for the inbox.

Output

The node outputs JSON data representing the updated inbox object as returned by the ChatWoot API. This typically includes fields such as the inbox ID, name, avatar URL, auto-assignment status, and channel configuration. The output can be used downstream to confirm the update or trigger further automation based on the updated inbox details.

No binary data output is involved.

Dependencies

Requires an active connection to the ChatWoot API.
Needs an API authentication token configured in n8n credentials to authorize requests.
The base URL for the ChatWoot instance must be provided in the credentials.

Troubleshooting

Invalid Account or Inbox ID: If the provided account or inbox ID does not exist, the API will return an error. Verify IDs before running the node.
Authentication Errors: Missing or invalid API credentials will cause authorization failures. Ensure the API key/token is correctly configured.
Malformed Channel JSON: The channel property expects valid JSON. Invalid JSON syntax will cause parsing errors. Use proper JSON formatting.
Empty Required Fields: Omitting required fields like account_id, id, or enable_auto_assignment will result in validation errors. Make sure all required inputs are provided.

Links and References

ChatWoot API Documentation – Official API reference for inbox management.
n8n Documentation – General guidance on using and configuring nodes in n8n.

ChatWootInstall