Create An Ad
Create a new Ad.
Request
- ad_account_idstring [uuid]Required
A unique identifier for an Ad Account.
Example value:"ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a"
- advertiser_namestringRequired
Name of the advertiser
Example value:"Heart Dance Recordings"
Length between2
and25
- Required
Assets for the ad.
- namestringRequired
Name given to identify your entity.
Example value:"Entity_1"
Pattern:^\S.*\S$
Length between2
and120
- taglinestring
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 between2
and40
- ad_set_idstring [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.
- deliverystring
Toggles the delivery of the entity ON or OFF.
Example value:"ON"
Default value:"ON"
Allowed values:"ON"
,"OFF"
Response
Ad response.
- advertiser_namestring
Name of the advertiser
Example value:"Heart Dance Recordings"
Length between2
and25
Assets for the ad.
- asset_idstring [uuid]Required
A unique identifier for the entity.
Example value:"ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a"
- companion_asset_idstring [uuid]Required
A unique identifier for the entity.
Example value:"ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a"
- logo_asset_idstring [uuid]
A unique identifier for the entity.
Example value:"ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a"
- namestring
Name given to identify your entity.
Example value:"Entity_1"
Pattern:^\S.*\S$
Length between2
and120
- taglinestring
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 between2
and40
Third party viewability tracking via partner and url
- measurement_partnerstring
Name of the third-party measurement partner.
Example value:"IAS"
Allowed values:"IAS"
,"DCM"
- urlstring [uri]
Third-party tracking URL.
Example value:"https://www.example.com/your-landing-page/?utm_campaign=test-campaign&utm_source=email"
- idstring [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.
- textstring
- languagestring
- clickthrough_urlstring [uri]
The link to the ads desired landing page.
Example value:"https://www.spotify.com"
- created_atstring [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_atstring [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"
- deliverystring
Toggles the delivery of the entity ON or OFF.
Allowed values:"ON"
,"OFF"
- ad_set_idstring [uuid]
A unique identifier for the entity.
Example value:"ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a"
- statusstring
Status of the ad.
Example value:"PENDING"
Allowed values:"ACTIVE"
,"APPROVED"
,"ARCHIVED"
,"PENDING"
,"PENDING_APPROVAL"
,"REJECTED"
,"UNRECOGNIZED"
- reject_reasonstring
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_urlstring [uri]
Preview url of an ad.
Example value:"https://www.adstudio.spotify.com/preview/8ae1f562-1b4e-11ee-be56-0242ac120002"