List Ads

List all ads in ad account with creative details and status, including review feedback (disapproval reasons) and delivery issues when Meta reports them

List all ads in ad account with creative details and status, including review feedback (disapproval reasons) and delivery issues when Meta reports them

App	Meta Ads
Operation ID	meta_ads_list_ads
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
campaign_effective_status	array of string or SelectableOption	No	-	Filter ads by parent campaign effective status. Multiple statuses can be selected. Supported values: ACTIVE, PAUSED, DELETED, ARCHIVED, IN_PROCESS, WITH_ISSUES
adset_effective_status	array of string or SelectableOption	No	-	Filter ads by parent ad set effective status. Multiple statuses can be selected. Supported values: ACTIVE, PAUSED, DELETED, CAMPAIGN_PAUSED, ARCHIVED, IN_PROCESS, WITH_ISSUES
ad_effective_status	array of string or SelectableOption	No	-	Filter ads by ad effective status. Multiple statuses can be selected. Supported values: ACTIVE, PAUSED, DELETED, PENDING_REVIEW, DISAPPROVED, PREAPPROVED, PENDING_BILLING_INFO, CAMPAIGN_PAUSED, ARCHIVED, ADSET_PAUSED, IN_PROCESS, WITH_ISSUES
filters	array of FilterItem	No	-	Additional filters to apply when retrieving ads. The available fields to filter by are: - campaign_id: Filter by parent campaign ID - campaign_name: Filter by parent campaign name - adset_id: Filter by parent ad set ID - adset_name: Filter by parent ad set name - ad_id: Filter by ad ID - ad_name: Filter by ad name Filters are combined using AND logic. If you want to use OR logic, use relevant operators like REGEXP_MATCH or IN_LIST. campaign_id, adset_id, and ad_id with EQUALS/IN_LIST, and ad_name with CONTAINS, are applied by Meta at the source, so they are fast on any account size. Other combinations are applied after fetching, scanning a bounded number of ads. Prefer the server-side combinations on large accounts.
limit	integer	No	500	Maximum number of matching ads to return (1-1000), counted after all filters are applied
include_creative	boolean	No	True	Include each ad’s creative payload (image URLs, story spec, asset feed spec, degrees of freedom spec). Set to false for lightweight results with ids, names, campaign/ad set info, statuses, and the preview link only; much faster and recommended for lookups on large accounts.
response_format	enum (flattened, raw)	No	flattened	Shape of the returned ads. ‘flattened’ (default) flattens nested Meta objects into top-level fields (for example campaign_id, adset_name, creative_image_url). ‘raw’ returns Meta’s response untouched, with campaign, adset, and creative kept as nested objects. Status and client-side filters work the same in both modes.

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, always as a string: text, a number, or a regex. For IN_LIST and NOT_IN_LIST, pass the values as one comma-separated string such as ‘a,b,c’, not as an array. For regex values, escape backslashes once in the JSON string: write \b for a word boundary, not \b.

SelectableOption

Field	Type	Required	Default	Description
value	string	Yes	-
label	string	Yes	-

Output

Type: List[Dict]

Returns list of ads with creative details.

Fields: dynamic (depend on the inputs)