List contact segments
list_segmentsView saved contact segments, their defining rules, and current matching member counts so you can review audience groups before planning a broadcast.
Instructions
Purpose: see the saved groups of contacts, the rules that define them, and how many people each currently matches. NOT for: sending to one. Who receives a broadcast is a person's decision. Returns: each segment with its rules and current size.
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": "list_segments"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Page size (1-100). | |
| cursor | No | next_cursor from the previous page. Omit for the first page. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | No | This page of rows. | |
| error | No | Present instead of the fields above when the call was refused: code, message, fix, docs_url, retryable and, when waiting helps, retry_after_seconds. | |
| has_more | No | True when another page follows. | |
| next_cursor | No | Pass back as cursor for the next page; null on the last page. |