List contacts
list_contactsRetrieve contacts already linked to the account, filter by email or audience, and page results ordered newest first.
Instructions
Purpose: look up the people this account already has a relationship with. Pass an email to find one. NOT for: finding addresses to contact for the first time. This product has no feature for that and will not grow one. Returns: each contact with its properties, newest first.
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 |
|---|---|---|---|
| No | Look up one contact by address. | ||
| limit | No | Page size (1-100). | |
| cursor | No | next_cursor from the previous page. Omit for the first page. | |
| audience_id | No | Limit the list to one audience. The id is a segment on this account. A value that is not an audience id lists every contact on the account. |
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. |