fetch_suppressions
List the account do-not-contact list: every address that unsubscribed, replied STOP, complained, bounced or was added by hand. Defaults to 25 per page, maximum 100. search takes ONE EXACT address; without a channel, a value containing @ is searched as email and anything else as SMS. Each row carries a reason — only reason manual can ever be removed, so check it before promising the user you can undo a suppression. Read-only and NOT gated by the Send Message module: only the writes of this category document a module-not-enabled 403. If this call returns 403, look for another cause before telling the user the module is off.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "fetch_suppressions"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number, starting at 1. Defaults to 1 | |
| search | No | ONE exact email address or phone number (max 254 characters) | |
| channel | No | email or sms | |
| items_per_page | No | Results per page, 1 to 100. Defaults to 25 |