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. 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_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}