| App | Snapchat Ads |
| Operation ID | snapchat_ads_list_ads |
| Type | Action |
| Connection | snapchat_ads (required) |
| Credits per run | 1 |
| Agent / MCP tool | Yes |
Inputs
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
account | DynamicAccount | Yes | - | Select the Snapchat Ads account whose ads should be listed. |
campaign_id | string or SelectItem | No | - | Optional campaign ID to list only that campaign’s ads. Lists all ads in the account when both campaign_id and ad_squad_id are omitted. |
ad_squad_id | string or SelectItem | No | - | Optional ad squad ID to list only that ad squad’s ads. Takes precedence over campaign_id. |
entity_statuses | array of string or SelectableOption | No | - | Filter ads by status: ACTIVE and/or PAUSED. Returns all statuses when omitted. |
filters | array of FilterItem | No | - | Additional filters to apply when retrieving ads. The available fields to filter by are: - id: Filter by ad ID - name: Filter by ad name - ad_squad_id: Filter by parent ad squad ID - creative_id: Filter by creative ID - type: Filter by ad type (SNAP_AD, REMOTE_WEBPAGE, APP_INSTALL, STORY, COLLECTION, etc.) - review_status: Filter by review status (PENDING, APPROVED, REJECTED) 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 ads to return. Default: 100. |
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. |
SelectItem
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
value | string | Yes | - | The value of the selectable item. |
label | string | Yes | - | The label of the selectable item, used for display purposes. If not provided, defaults to the value. |
SelectableOption
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
value | string | Yes | - | |
label | string | Yes | - |
Output
Type:List[Dict]
Returns the list of Snapchat ads with full details.
Fields: dynamic (depend on the inputs)