> ## Documentation Index
> Fetch the complete documentation index at: https://docs.markifact.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.