| App | Meta Ads |
| Operation ID | meta_ads_list_campaigns |
| Type | Action |
| Connection | meta_ads (required) |
| Credits per run | 1 |
| Agent / MCP tool | Yes |
Inputs
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
account | DynamicAccount | Yes | - | Select Meta Ads account, ask the user for it if not provided |
effective_status | array of string or SelectableOption | No | - | Filter campaigns by effective status. Multiple statuses can be selected. Supported values: ACTIVE, PAUSED, DELETED, ARCHIVED, IN_PROCESS, WITH_ISSUES |
filters | array of FilterItem | No | - | Additional filters to apply when retrieving campaigns. The only available fields to filter by are: - campaign_id - campaign_name Filters are combined using AND logic. If you want to use OR logic, use relevant operators like REGEXP_MATCH or IN_LIST. |
limit | integer | No | 100 | Maximum number of campaigns to return (1-1000) |
FilterItem
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
field | string or SelectableOption | Yes | - | The field to filter on, must be one of the current selected metrics or dimensions. |
operator | string | Yes | - | The operator to use for filtering. Must be one of the supported values. Use REGEXP_MATCH to search/filter by multiple OR values like ’.(summer|holiday).’ |
value | string | Yes | - | The value to filter by. Can be a string, number, regex, or a list of strings. |
SelectableOption
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
value | string | Yes | - | |
label | string | Yes | - |
Output
Type:List[Dict]
Returns list of campaigns like id, name, status, effective_status,etc.