account | DynamicAccount | Yes | - | Select the Snapchat Ads account whose ad squads should be listed. |
campaign_id | string or SelectItem | No | - | Optional campaign ID to list only that campaign’s ad squads. Lists all ad squads in the account when omitted. |
entity_statuses | array of string or SelectableOption | No | - | Filter ad squads by status: ACTIVE and/or PAUSED. Returns all statuses when omitted. |
filters | array of FilterItem | No | - | Additional filters to apply when retrieving ad squads. The available fields to filter by are: - id: Filter by ad squad ID - name: Filter by ad squad name - campaign_id: Filter by parent campaign ID - type: Filter by ad squad type (SNAP_ADS, LENS, FILTER) - optimization_goal: Filter by optimization goal 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 ad squads to return. Default: 100. |