Set conversation status
Change a conversation to active, pending or closed.
MCP tool help_scout_write → set_conversation_status
write
Changes the status without sending a reply, as the status control in the conversation does. Closing removes the conversation from the open folders; a new customer email opens it again. Spam is left out on purpose: marking spam teaches Help Scout to send that sender to Spam from then on. The change reaches no customer and one call undoes it, so it does not ask for your OK.
Parameters
| Name | Type | Description |
|---|---|---|
| conversation_id integer required | integer | Conversation number from search_conversations. |
| status enum required | enum | active, pending or closed. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "help_scout_write",
"arguments": {
"operation": "set_conversation_status",
"arguments": {
"conversation_id": 1,
"status": "active"
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"conversation_id": 48190,
"status": "closed",
"previous_status": "pending"
},
"isError": false
}