Skip to content

Tool

list_subscribers

List subscribers

Read-onlyIdempotent
SurfacesChat agentMCPCLI

List subscribers (members) in an audience, optionally filtered by status or tag. Returns email, name, status, and subscription date.

CLI: tinbox list-subscribers

Parameters

NameTypeRequiredDescription
audienceIdstringyesThe audience id.
statussubscribedunsubscribedpendingcleanedtransactionalnoFilter by subscription status.
tagstringnoFilter by tag name.
searchstringnoSearch by email or name.
limitnumbernoMax results (default 50, max 200).

Example

json
{
  "audienceId": "aud_…"
}