Create Carousel Ad

Creates a Spotify carousel ad that listeners swipe through, from a logo and 2 to 6 cards, each with its own image, tagline, destination URL and optional price

Creates a Spotify carousel ad that listeners swipe through, from a logo and 2 to 6 cards, each with its own image, tagline, destination URL and optional price. Uploads any file given as a URL. The ad set’s creative format must be CATALOG.

App	Spotify Ads
Operation ID	spotify_ads_create_carousel_ad
Type	Action
Connection	spotify_ads (required)
Credits per run	1
Agent / MCP tool	Yes
Requires approval	Yes (write operation)

Inputs

Field	Type	Required	Default	Description
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	string or array of any	No	-	Up to 11 third party tracking entries, sent as-is. Each item is {measurement_partner: IAS|DCM|UNSET, url}.
cards	array of object or string	Yes	-	JSON list of 2 to 6 carousel cards, shown in the order given. Each card takes image_url (required; square JPEG or PNG, at least 600x600, or the id of an existing asset), tagline (required, 2 to 40 characters) and clickthrough_url (required), plus optional sku, price, sale_price (amounts in the ad account’s currency) and currency_code. The first card’s tagline and clickthrough URL also become the ad’s own, matching how Spotify’s Ads Manager builds carousel ads. Example: [{“image_url”: “https://example.com/a.jpg”, “tagline”: “Artisan bowl”, “clickthrough_url”: “https://example.com/a”, “price”: 20}, {“image_url”: “https://example.com/b.jpg”, “tagline”: “Ceramic mug”, “clickthrough_url”: “https://example.com/b”}]

SelectItem

Field	Type	Required	Default	Description
value	string	Yes	-	The value of the selectable item.
label	string	Yes	-	The label of the selectable item, used for display purposes. If not provided, defaults to the value.

Output

Type: Dict

Returns the created ad including id, ad_set_id, name, status, assets, call_to_action, catalog with its items, and ad_preview_url.

Fields: dynamic (depend on the inputs)