list_advertisers
List the advertisers (ad accounts) in your organization, optionally filtered by provider.
Lists every advertiser connected to your organization. Use this first to find
the advertiserIds you’ll pass to the other tools.
Input
| Field | Type | Required | Description |
|---|---|---|---|
provider | 'meta' | 'tiktok' | 'x' | 'snapchat' | no | Restrict to one provider. |
status | 'ACTIVE' | 'DISABLED' | no | Filter by sync status. |
Output
An array of advertisers. Each entry has id (acc_*), provider, name,
and status.
Example
“Show me my Meta advertisers.”
Claude calls list_advertisers({ provider: 'meta' }) and reads back the list
with their AdCrunch IDs.
Stable IDs
acc_* IDs are stable across syncs and across providers. The agent should
refer to advertisers by acc_* ID, not by name, when chaining tools.
Errors
401 Unauthorized— the OAuth token has expired. Re-authorize from your AI client’s settings.