List Meta campaigns / ad sets / ads
list_meta_adsRead-only
Retrieve campaigns, ad sets, or ads from a connected Meta ad account. Filter by status, campaign, or ad set to inspect account activity before making changes.
Instructions
Read the EXISTING campaigns, ad sets, or ads on a connected Meta ad account — id, name, status, budget, objective. Pass adAccountId (from list_meta_pages) and level (campaign|adset|ad). Scope to a parent with campaignId (→ its ad sets/ads) or adsetId (→ its ads), and filter by status (ACTIVE/PAUSED/…). Read-only — use it to inspect an account before editing/deleting, or to answer "what’s running?".
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| level | No | what to list (default campaign) | |
| limit | No | max rows (1–200, default 50) | |
| status | No | filter by effective status, e.g. ACTIVE / PAUSED | |
| adsetId | No | list the ads under this ad set | |
| campaignId | No | list the ad sets / ads under this campaign | |
| adAccountId | Yes | ad account id (act_… or digits — from list_meta_pages) |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| count | No | ||
| items | No | ||
| level | No | ||
| cursor | No |