Actions113
- 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
- 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
Overview
The "Update A Team" operation in the Teams resource allows users to modify the details of an existing team within their account. This node is useful for managing team configurations dynamically, such as changing a team's name, updating its description, or adjusting assignment settings. Practical scenarios include reorganizing teams after company restructuring, correcting team information, or enabling/disabling automatic conversation assignments to agents.
Properties
| Name | Meaning |
|---|---|
| Account Id | The numeric ID of the account where the team exists; required to identify the correct account. |
| Team Id | The unique numeric identifier of the team to be updated; required to specify which team to update. |
| Name | The new name for the team. |
| Description | A textual description providing more details about the team. |
| Allow Auto Assign | Boolean flag indicating if conversations assigned to this team should automatically be assigned to an agent within the team. Options: true (enabled), false (disabled). |
Output
The node outputs JSON data representing the updated team object as returned by the ChatWoot API. This typically includes fields such as the team's ID, name, description, and configuration flags like auto-assignment status. The output can be used downstream in workflows to confirm updates or trigger further actions based on the updated team data.
No binary data output is involved in this operation.
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 set in the credentials.
Troubleshooting
Common Issues:
- Invalid or missing Account Id or Team Id will cause the update to fail.
- Insufficient permissions or invalid API token may result in authorization errors.
- Providing empty or malformed values for properties like name or description might lead to API validation errors.
Error Messages:
- "Team not found" — Verify that the Team Id is correct and belongs to the specified Account Id.
- "Unauthorized" — Check that the API key credential is valid and has necessary permissions.
- "Invalid input" — Ensure all required fields are provided and correctly formatted.
Resolving these usually involves verifying input parameters, checking API credentials, and ensuring network connectivity to the ChatWoot service.
Links and References
- ChatWoot API Documentation – Official API reference for team management endpoints.
- n8n Documentation – General guidance on using and configuring nodes in n8n workflows.