Unsubscribe contacts
Mark contacts as unsubscribed in bulk, by segment, tag or email addresses.
MCP tool emailoctopus_write → unsubscribe_contacts
write Confirm
Does what Actions, then Mark as unsubscribed, does on the contacts page. Give exactly one of segment, tag or emails. Unsubscribed contacts stay in the list and stop counting towards your plan's subscriber limit; the tool never deletes a contact. An unsubscribed contact cannot be re-subscribed through an import. It returns how many contacts changed. By default you confirm each call; you can switch that off for this tool.
Parameters
| Name | Type | Description |
|---|---|---|
| list_id string required | string | List ID from list_lists. |
| segment string | string | Segment name from list_segments. |
| tag string | string | Unsubscribe the contacts with this tag. |
| emails array | array | Email addresses to unsubscribe. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "emailoctopus_write",
"arguments": {
"operation": "unsubscribe_contacts",
"arguments": {
"list_id": "4d1c8e5a-7f2b-4c1e-9a63-0b5d2e8f1a37",
"segment": "Inactive for 90 days"
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"list_id": "4d1c8e5a-7f2b-4c1e-9a63-0b5d2e8f1a37",
"segment": "Inactive for 90 days",
"unsubscribed": 212
},
"isError": false
}