Add addresses to my unsubscribe list
suppression_addAdd your own addresses to your unsubscribe list (stored as keyed hashes); unsubscribes through your links join it by themselves. keep_address true also keeps them sealed so suppression_export gives them back. At most 50,000 per list, all or nothing; a listed address keeps its reason (already_listed). Undo: suppression_remove.
Example tool call
This call uses example arguments supplied in the tool’s input schema.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"emails": [
"reader@example.com"
],
"reason": "bounce",
"instance_id": "sup_exampleexampleexample2"
},
"name": "suppression_add"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| emails | Yes | Plain addresses, up to 1000. | |
| reason | No | Why (default manual). | |
| instance_id | Yes | Utility instance id from buy or list_utilities. | |
| keep_address | No | Also keep the address sealed for export (default false: hash only). | |
| passport_token | No | Your amp_ token, only if you have no app sign-in and cannot send a header. |