Mail

mail_contact_list

List contacts in an audience

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
audience_id	string	•	Audience to list contacts from
unsubscribed	string	—	Filter by unsubscribed flag

Field	Type	Always	Description
data	array	•
nextCursor	string	•

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>"
}