Skip to content
Ads APIReferences / Ads / Create Ad

Create Ad

Creates a new ad.

Request

  • ad_account_id
    string [uuid]
    Required
  • advertiser_id
    string [uuid]
    Required

    The Unique ID returned back when a new advertiser is created.

  • Required
    • audio_asset_id
      string [uuid]

      The audio ID provided back when an audio upload url is requested. Note this does not mean it's processed successfully; you will need to check the status for that.

      Example: "2f5488b7-0a48-4751-b3b8-701df2d8cd90"
    • video_asset_id
      string [uuid]

      The video ID provided back when a upload url is requested. Note this does not mean it's processed successfully; you will need to check the status for that.

      Example: "2f5488b7-0a48-4751-b3b8-701df2d8cd90"
    • companion_asset_id
      string [uuid]
      Required

      The ID provided back when an companion image upload url is requested. Note this does not mean its Processed successfully, you will need to check the status for that* bbbv , cv.

  • clickthrough_url
    string [uri]
    Required

    The link to the ads desired landing page activated by a button labelled CTA below and also the cover art image.

    Example: "www.spotify.com"
  • landing_page_domain
    string [uri]
    Required

    URL the campaign will direct to

    Example: "www.spotify.com"
  • name
    string
    Required

    Name given to identify your ad.

    Example: "Spotify Discover Weekly feature ad"
  • tagline
    string
  • brand_name
    string
    Required

    Brand name of your ad.

    • measurement_partner
      string [measurement-partner]
      Allowed values: "IAS"Example: "IAS"
    • url
      string

Response

  • id
    string [uuid]

    ID for the actual ad ad that will be displayed to the user. It is a container for assets and metadata for the ad. It contains asset IDs which are generated via the asset endpoint.

Response sample

{  "id": "pa66a2eb-35cf-46a4-8d2e-0j95dfc133r7"}