Ads API •References / campaigns / Get Draft Campaigns

Get Draft Campaigns

Get a list of draft campaigns for the ad account.

Request

ad_account_idstring [uuid]
Required
A unique identifier for an Ad Account.
Example: ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a
limitinteger
Limit or page size for a given response.
Default: limit=50Range: 1 - 50Example: limit=50
offsetinteger
Starting position of the next record to assist in data pagination.
Default: offset=0Example: offset=0
campaign_idsarray of strings
A list of campaigns to return.
A unique identifier for the entity.
Example: campaign_ids=ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a
channelarray of strings
Filter by campaign's channel
Channel to identify the booking flow which the campaign was created.
Default: channel=UNSETAllowed values: "UNSET", "UNKNOWN"
statusesarray of strings
Filter by campaign's status
Current state of campaign.
Allowed values: "UNSET", "ACTIVE", "PAUSED", "ARCHIVED", "AGENT_CONTROLLED", "ACTIVE_RESTRICTED", "PENDING_ADVERTISER_REVIEW", "UNRECOGNIZED"Example: statuses=ACTIVE
sort_fieldstring
Field by which to sort campaigns.
Default: sort_field=CREATED_ATAllowed values: "ID", "NAME", "CREATED_AT", "UPDATED_AT", "STATUS"Example: sort_field=CREATED_AT
sort_directionstring
Field by which to order the results of the query.
Default: sort_direction=DESCAllowed values: "ASC", "DESC"Example: sort_direction=ASC

Response

Metadata for a single draft campaign.

- page_sizeinteger [int32]
- total_resultsinteger [int32]
- offsetinteger [int32]
- current_pageinteger [int32]
- idstring [uuid]
  A unique identifier for the entity.
  Example: "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a"
- created_atstring [date-time]
  Date the entity was created. Time should be in ISO 8601 format using Coordinated Universal Time (UTC) with a zero offset: YYYY-MM-DDTHH:MM:SSZ
  Example: "2026-01-23T04:56:07Z"
- updated_atstring [date-time]
  Date the entity was updated. Time should be in ISO 8601 format using Coordinated Universal Time (UTC) with a zero offset: YYYY-MM-DDTHH:MM:SSZ
  Example: "2026-01-23T04:56:07Z"
- namestring
  Name given to identify your campaign.
  Maximum length: 200Example: "Spotify Ads Summer Campaign 2022"
- purchase_orderstring
  A purchase order number, to be shown on your invoice, for your own personal organization.
  Maximum length: 45Example: "ORDER_1"
- objectivestring
  Deprecated
  Deprecated: Use delivery_goal_group and delivery_goal on ad sets instead. Objective for a campaign. UNSET should not be used.
  Allowed values: "UNSET", "REACH", "EVEN_IMPRESSION_DELIVERY", "CLICKS", "VIDEO_VIEWS", "PODCAST_STREAMS"Example: "EVEN_IMPRESSION_DELIVERY"
- channelstring
  Channel to identify the booking flow which the campaign was created.
  Allowed values: "UNSET"
- ad_productstring
  The ad product of the campaign being created.
  Allowed values: "UNSET"
- salesforce_opportunitystring
  Salesforce opportunity code.
  Maximum length: 200Example: "S0067S000009GF0ZQAW"
- salesforce_sales_orderstring
  Salesforce sales order code.
  Maximum length: 200Example: "SO-765621"
- delivery_goal_groupstring
  deliveryGoal group grouping selection for a campaign.
  Allowed values: "UNSET", "AWARENESS", "WEBSITE_TRAFFIC", "APP_PROMOTION", "ENGAGEMENT_ON_SPOTIFY", "LEAD_GEN"
- media_plan_idstring [uuid]
  Read only
  Optional ID of the media plan associated with this campaign
- statusstring
  Current state of campaign.
  Allowed values: "UNSET", "ACTIVE", "PAUSED", "ARCHIVED", "AGENT_CONTROLLED", "ACTIVE_RESTRICTED", "PENDING_ADVERTISER_REVIEW", "UNRECOGNIZED"Example: "ACTIVE"
- needs_advertiser_reviewboolean
  Read only
  Indicates whether this draft was created or modified by an impersonator and needs review before publishing
  Example: false
- ad_account_idstring [uuid]
  A unique identifier for the entity.
  Example: "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a"
- modified_by_rolestring
  The role that last modified the draft.
  Allowed values: "ADVERTISER", "IMPERSONATOR"Example: "ADVERTISER"
- draft_hierarchy_versioninteger
  Read only
  The version of the draft hierarchy.
  Minimum value: 1Example: 1

Response sample

{  "paging": {    "page_size": 0,    "total_results": 0,    "offset": 0,    "current_page": 0  },  "campaign_drafts": [    {      "id": "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a",      "created_at": "2026-01-23T04:56:07Z",      "updated_at": "2026-01-23T04:56:07Z",      "name": "Spotify Ads Summer Campaign 2022",      "purchase_order": "ORDER_1",      "objective": "EVEN_IMPRESSION_DELIVERY",      "channel": "UNSET",      "ad_product": "UNSET",      "salesforce_opportunity": "S0067S000009GF0ZQAW",      "salesforce_sales_order": "SO-765621",      "delivery_goal_group": "UNSET",      "media_plan_id": "string",      "status": "ACTIVE",      "needs_advertiser_review": false,      "ad_account_id": "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a",      "modified_by_role": "ADVERTISER",      "draft_hierarchy_version": 1    }  ]}