Skip to content
Ads API •References / ads / Create An Ad

Create An Ad

Create a new Ad.

Request

  • ad_account_id
    string [uuid]
    Required

    A unique identifier for an Ad Account.

    Example value: "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a"
  • advertiser_name
    string
    Required

    Name of the advertiser

    Example value: "Heart Dance Recordings"Length between 2 and 25
  • Required

    Assets for the ad.

  • name
    string
    Required

    Name given to identify your entity.

    Example value: "Entity_1"Pattern: ^\S.*\S$Length between 2 and 120
  • tagline
    string

    Tagline to give listeners more context about your company or product. This will be displayed in the CTA card leavebehind.

    Example value: "Good Food for Good Dogs"Pattern: ^\S.*\S$Length between 2 and 40
  • ad_set_id
    string [uuid]
    Required

    A unique identifier for the entity.

    Example value: "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a"
  • Required

    The metadata for the behavior of the call-to-action button.

  • delivery
    string

    Toggles the delivery of the entity ON or OFF.

    Example value: "ON"Default value: "ON"Allowed values: "ON", "OFF"

Response

Ad response.

  • advertiser_name
    string

    Name of the advertiser

    Example value: "Heart Dance Recordings"Length between 2 and 25

  • Assets for the ad.

    • asset_id
      string [uuid]
      Required

      A unique identifier for the entity.

      Example value: "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a"
    • companion_asset_id
      string [uuid]
      Required

      A unique identifier for the entity.

      Example value: "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a"
    • logo_asset_id
      string [uuid]

      A unique identifier for the entity.

      Example value: "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a"
  • name
    string

    Name given to identify your entity.

    Example value: "Entity_1"Pattern: ^\S.*\S$Length between 2 and 120
  • tagline
    string

    Tagline to give listeners more context about your company or product. This will be displayed in the CTA card leavebehind.

    Example value: "Good Food for Good Dogs"Pattern: ^\S.*\S$Length between 2 and 40

  • Third party viewability tracking via partner and url

    • measurement_partner
      string

      Name of the third-party measurement partner.

      Example value: "IAS"Allowed values: "IAS", "DCM"
    • url
      string [uri]

      Third-party tracking URL.

      Example value: "https://www.example.com/your-landing-page/?utm_campaign=test-campaign&utm_source=email"
  • id
    string [uuid]

    A unique identifier for the entity.

    Example value: "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a"

  • The metadata for the behavior of the call-to-action button.

    • text
      string
    • language
      string
    • clickthrough_url
      string [uri]

      The link to the ads desired landing page.

      Example value: "https://www.spotify.com"
  • created_at
    string [date-time]

    Date the ad set was created. Time should be in ISO 8601 format using Coordinated Universal Time (UTC) with a zero offset: YYYY-MM-DDTHH:MM:SSZ

    Example value: "2026-01-23T04:56:07Z"
  • updated_at
    string [date-time]

    Date the ad set was updated. Time should be in ISO 8601 format using Coordinated Universal Time (UTC) with a zero offset: YYYY-MM-DDTHH:MM:SSZ

    Example value: "2026-01-23T04:56:07Z"
  • delivery
    string

    Toggles the delivery of the entity ON or OFF.

    Allowed values: "ON", "OFF"
  • ad_set_id
    string [uuid]

    A unique identifier for the entity.

    Example value: "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a"
  • status
    string

    Status of the ad.

    Example value: "PENDING"Allowed values: "ACTIVE", "APPROVED", "ARCHIVED", "PENDING", "PENDING_APPROVAL", "REJECTED", "UNRECOGNIZED"
  • reject_reason
    string

    Reason the ad has been put into the REJECTED state (if applicable).

    Example value: "Your ad wasn’t approved. Create a new ad, or contact us at adstudio@spotify.com."
  • ad_preview_url
    string [uri]

    Preview url of an ad.

    Example value: "https://www.adstudio.spotify.com/preview/8ae1f562-1b4e-11ee-be56-0242ac120002"

Response sample