account | DynamicAccount | Yes | - | Select the Spotify Ads account to create the ad in. |
ad_set_id | string or SelectItem | Yes | - | Ad set the ad belongs to. Its creative format must match this operation, and it is checked before the ad is created. |
name | string | Yes | - | Ad name, 2 to 200 characters. |
advertiser_name | string | Yes | - | Advertiser name shown with the ad, 2 to 25 characters. |
logo_url | string | Yes | - | Square logo image, JPEG or PNG, at least 600x600. Accepts a direct URL, a Google Drive share link (set to ‘Anyone with the link’), a Markifact uploaded file, or the id of an asset already in the account (from spotify_ads_list_assets or spotify_ads_upload_media). |
call_to_action_key | enum (APPLY_NOW, BOOK_NOW, BUY_NOW, BUY_TICKETS, CLICK_NOW, DOWNLOAD, FIND_STORES, GET_COUPON, …) | No | - | Button text on the call to action card, for example LEARN_MORE, LISTEN_NOW, SHOP_NOW. Spotify defaults to LEARN_MORE. |
call_to_action_language | enum (ARABIC, ARABIC_EGYPT, BULGARIAN, CHINESE, CHINESE_HK, CHINESE_TAIWAN, CROATIAN, CZECH, …) | No | - | Language the button text is shown in. Spotify defaults to ENGLISH. |
start_time | string | No | - | When the ad starts, ISO 8601 UTC. Inherits the ad set schedule when omitted. |
end_time | string | No | - | When the ad stops, ISO 8601 UTC. |
delivery | enum (ON, OFF) | No | - | Whether the ad starts delivering (ON) or paused (OFF). |
dv_client_code | string | No | - | DoubleVerify client code for third party verification. |
third_party_tracking | array of any or string | No | - | Up to 11 third party tracking entries, sent as-is. Each item is {measurement_partner: IAS|DCM|UNSET, url}. |
tagline | string | Yes | - | Short message shown next to the call to action, 2 to 40 characters. |
clickthrough_url | string | No | - | Destination URL the call to action opens. |
audio_url | string | Yes | - | Audio clip for the ad, around 30 seconds, MP3, WAV or OGG. Accepts a direct URL, a Google Drive share link (set to ‘Anyone with the link’), a Markifact uploaded file, or the id of an asset already in the account (from spotify_ads_list_assets or spotify_ads_upload_media). |
companion_image_url | string | Yes | - | Companion image shown while the audio plays, JPEG or PNG, at least 600x500. Accepts a direct URL, a Google Drive share link (set to ‘Anyone with the link’), a Markifact uploaded file, or the id of an asset already in the account (from spotify_ads_list_assets or spotify_ads_upload_media). |