mail_contact_list

Tool

List contacts in an audience

Name	Type	Required	Description
limit	integer	—	Max items per page (1–100, default 50)
cursor	string	—	Opaque pagination cursor from a prior page; omit for the first page
audience_id	string	•	Audience to list contacts from
unsubscribed	string	—	Filter by unsubscribed flag

Field	Type	Always	Description
data	array	•	Contacts on this page, newest first
nextCursor	string	•	Cursor for the next page; null on the last page

List contacts in an audience.

When to use

List contacts in an audience

Ask your agent something like this:

List contacts in an audience.

The agent will invoke mail_contact_list with these arguments:

{
  "audience_id": "<audience_id>"
}