account | DynamicAccount | Yes | - | Select the Spotify Ads account whose campaigns should be listed. |
entity_statuses | array of string or SelectableOption | No | - | Filter campaigns by status: ACTIVE, PAUSED, ARCHIVED, ACTIVE_RESTRICTED, AGENT_CONTROLLED, PENDING_ADVERTISER_REVIEW. 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 campaigns), 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 campaigns. The available fields to filter by are: - id: Filter by campaign ID - name: Filter by 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. Default: 100. |