Tag conversation
Add or remove tags on one conversation.
MCP tool help_scout_write → tag_conversation
write
Adds the tags in add and removes the ones in remove, with the Add or remove conversation tags permission your account needs. A tag that does not exist is created by adding it, so check list_tags first. Returns the full tag list after the change. Tags reach no customer and one call undoes the change, so it does not ask for your OK.
Parameters
| Name | Type | Description |
|---|---|---|
| conversation_id integer required | integer | Conversation number from search_conversations. |
| add array | array | Tag names to add. |
| remove array | array | Tag names to remove. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "help_scout_write",
"arguments": {
"operation": "tag_conversation",
"arguments": {
"conversation_id": 48244,
"add": [
"billing"
]
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"conversation_id": 48244,
"tags": [
"billing"
],
"added": [
"billing"
],
"removed": []
},
"isError": false
}