Add labels
Add labels to a conversation and keep the ones it has.
MCP tool chatwoot_write → add_labels
write
Adds the labels you pass to the existing ones and returns the full list. A name that is not in list_labels fails and nothing is changed. Labels are account-specific and are not created by this tool. add_labels runs without asking first: it reaches no customer and is undone with one call.
Parameters
| Name | Type | Description |
|---|---|---|
| conversation_id integer required | integer | conversation_id from list_conversations. It is the number in the conversation URL. |
| labels string[] required | string[] | Label names from list_labels. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "chatwoot_write",
"arguments": {
"operation": "add_labels",
"arguments": {
"conversation_id": 1842,
"labels": [
"billing",
"refund"
]
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"conversation_id": 1842,
"labels": [
"billing",
"refund"
],
"added": [
"billing",
"refund"
]
},
"isError": false
}