Ads API •References / campaigns / Get Draft Campaign by ID

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"
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

{  "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}