list_entities
List ad entities (campaigns, ad sets, ad groups, ads, creatives, …) under one advertiser, filtered by type or parent.
Lists ad entities of any level under a single advertiser. One generic tool
covers every entity type across providers — filter by the provider-native
type (campaign, adset, ad_group, ad, creative, …) and/or by parentId to
walk the tree. Use list_advertisers first to
get the advertiserId.
Input
| Field | Type | Required | Description |
|---|---|---|---|
advertiserId |
acc_* |
yes | The advertiser to list under. Must belong to your organization. |
type |
string |
no | Provider-native entity type, e.g. campaign, adset, ad_group, ad, creative. |
parentId |
string (type:id) |
no | Return only direct children of this entity, e.g. campaign:123. |
status |
'ACTIVE' | 'PAUSED' | 'DELETED' | 'ARCHIVED' |
no | Filter by normalized status. |
ids |
string[] |
no | Restrict to specific entity IDs. |
limit |
number (1–500) |
no | Page size. |
offset |
number |
no | Page offset. |
Output
{ entities: [...] } — an array of entity metadata rows. Each carries
provider, type, id (bare, provider-native), name, status,
advertiserId, parentId (type:id), and path (the ancestor chain). This
is lean metadata; for the full provider-native payload of one entity, use
get_entity.
Example
“List the active campaigns for that advertiser.”
Claude calls list_entities({ advertiserId: 'acc_123', type: 'campaign', status: 'ACTIVE' })
and reads back the campaigns with their IDs, then can drill into one with
parentId: 'campaign:<id>'.
Provider-native types
type is the provider’s own word — Meta uses adset, TikTok and Google use
ad_group. Discover the exact types by listing without a type filter first.
Errors
401 Unauthorized— the OAuth token has expired. Re-authorize from your AI client’s settings.