List campaigns (adsap_list_campaigns)
Platform: Meta · Read or write: Read · Plan: All plans · Consumes a task: No · Preview supported: No
What it does
Lists the campaigns in a Meta ad account with budget, schedule and objective. You can filter by status or objective and page through long lists. In assistants that support interactive cards, the list renders as a card where you tick the campaigns you want to work with next.
Parameters
Descriptions are shortened from the tool schema. Your assistant sees the full text.
| Name | Type | Required | Description |
|---|---|---|---|
ad_account_id | string | No | |
status_filter | one of ACTIVE, PAUSED, DELETED, ARCHIVED, ALL | No | |
objective_filter | array of string | No | |
limit | number | No | |
cursor | string | No |
Example prompts
- “List the active campaigns in my ad account.”
- “Show me every paused sales campaign.”
- “Which campaigns are running right now, and what is each one’s budget?”
Related tools
adsap_create_campaign: Create Meta campaign.adsap_list_apps: List the apps an ad account can promote: use to pick application_id + object_store_url for App promotion (OUTCOME_APP_PROMOTION)…
Guide
Read Creating a campaign for the workflow around this tool, and the Tool reference for every tool.
Last updated on