Get Draft Campaign by ID
Returns draft campaign based on a given draft campaign ID.
Request
- ad_account_idstring [uuid]Required
A unique identifier for an Ad Account.
Example:ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a - draft_campaign_idstring [uuid]Required
A unique identifier for the entity.
Example:ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a
Response
Metadata for a single draft campaign.
- 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" - objectivestringDeprecated
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. UNSET is deprecated: omit the field instead and the server applies its default. It is still accepted and normalized, and may still appear in responses for older campaigns. v4 requests do not accept it.
Allowed values:"UNSET" - ad_productstring
The ad product of the campaign being created. UNSET is deprecated: omit the field instead and the server applies its default. It is still accepted and normalized, and may still appear in responses for older campaigns. v4 requests do not accept it.
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","VIDEO_VIEWS" - 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_reviewbooleanRead 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_versionintegerRead only
The version of the draft hierarchy.
Minimum value:1Example:1
Response sample
{ "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}