list_contacts
List addressbook contacts filtered by status, tags, or fuzzy search to retrieve numeric contact IDs for serving pattern lookups.
Instructions
List addressbook contacts, optionally filtered by status, tag, or a fuzzy search string.
Use this to find a contact's numeric ID (person_id, with person_type "addressbook_contact") for use with find_serving_pattern. The fuzzy search (q) matches against first_name, last_name, formal_name, email, telephone, mobile, address, job, and employer.
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_contacts"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| status | No | ||
| q | No | ||
| tag_ids | No | ||
| page | No | ||
| per_page | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||