Create Carousel Ad - Markifact

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`	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}.
`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)