Assign conversation
Assign a conversation to a teammate, a team or nobody.
MCP tool help_scout_write → assign_conversation
write
Sets the Assignee of the conversation, as the Assignee field in the Details card does. Assign to a user by name or email; a team needs the Plus or Pro plan; pass unassigned to clear it. Light Users cannot be assigned conversations, and the call returns that error instead of changing anything. Assignment 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. |
| assignee string required | string | User name or email, a team name (Plus or Pro plan), or 'unassigned'. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "help_scout_write",
"arguments": {
"operation": "assign_conversation",
"arguments": {
"conversation_id": 1,
"assignee": "assignee"
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"conversation_id": 48244,
"assignee": "Maria Silva",
"previous_assignee": null,
"folder": "Assigned"
},
"isError": false
}