meta_ads_campaigns_list
Retrieve a list of Meta Ads campaigns from an account with optional status filtering. Returns campaign IDs, names, statuses, objectives, and budgets to enable campaign management or further operations.
Instructions
Lists campaigns in a Meta Ads account with optional status filtering. Returns id, name, status (ACTIVE / PAUSED / DELETED / ARCHIVED), effective_status, objective (OUTCOME_SALES / OUTCOME_LEADS / etc.), buying_type, daily_budget, and lifetime_budget per campaign. Read-only. Use this to find a campaign_id before calling campaigns.get or the pause/enable helpers. For a single campaign's full detail record use meta_ads_campaigns_get.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| account_id | No | Meta Ads account ID in the format 'act_XXXXXXXXXX' (e.g. 'act_1234567890'). Optional — falls back to META_ADS_ACCOUNT_ID from the configured credentials. The leading 'act_' prefix is required. | |
| status_filter | No | Restrict results to campaigns with this status. Omit to return all non-DELETED statuses. | |
| limit | No | Maximum records to return in a single call. Default 50. Meta Graph API caps at 1000 per page; for larger result sets reduce limit and filter client-side on the returned fields. |