Inputs
FilterItem
SelectItem
SelectableOption
Output
Type:List[Dict]
Returns the list of Spotify ad sets with full details including budget, targeting, and status.
Fields: dynamic (depend on the inputs)Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Lists ad sets in a Spotify Ads account with full details, optionally filtered to one campaign
| App | Spotify Ads |
| Operation ID | spotify_ads_list_ad_sets |
| Type | Action |
| Connection | spotify_ads (required) |
| Credits per run | 1 |
| Agent / MCP tool | Yes |
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
account | DynamicAccount | Yes | - | Select the Spotify Ads account whose ad sets should be listed. |
campaign_id | string or SelectItem | No | - | Only list ad sets in this campaign. Lists all ad sets in the account when omitted. |
entity_statuses | array of string or SelectableOption | No | - | Filter ad sets by status: ACTIVE, ACTIVE_RESTRICTED, APPROVED, ARCHIVED, COMPLETED, PENDING_APPROVAL, READY, REJECTED. Returns all statuses when omitted. |
draft_filter | enum (PUBLISHED_ONLY, INCLUDE_DRAFTS, DRAFTS_ONLY) | No | PUBLISHED_ONLY | Which records to return: PUBLISHED_ONLY (default, live ad sets), INCLUDE_DRAFTS (published plus drafts from the Spotify drafts endpoint, with every row flagged by is_draft), or DRAFTS_ONLY. |
filters | array of FilterItem | No | - | Additional filters to apply when retrieving ad sets. The available fields to filter by are: - id: Filter by ad set ID - name: Filter by ad set name - campaign_id: Filter by parent campaign ID 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 sets to return. Default: 100. |
| 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. |
| 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. |
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
value | string | Yes | - | |
label | string | Yes | - |
List[Dict]
Returns the list of Spotify ad sets with full details including budget, targeting, and status.
Fields: dynamic (depend on the inputs)