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

> Advanced: creates a Spotify ad from already-uploaded asset ids, for cases the per-format operations do not cover

Advanced: creates a Spotify ad from already-uploaded asset ids, for cases the per-format operations do not cover. Prefer spotify\_ads\_create\_audio\_ad, spotify\_ads\_create\_video\_ad, spotify\_ads\_create\_display\_ad or spotify\_ads\_create\_carousel\_ad, which accept media URLs directly.

| | |
| - | - |
| **App** | Spotify Ads |
| **Operation ID** | `spotify_ads_create_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. The ad set's asset\_format decides which creative this ad needs. |
| `name` | string | Yes | - | Ad name, 2 to 200 characters. |
| `advertiser_name` | string | Yes | - | Advertiser name shown with the ad, 2 to 25 characters. |
| `tagline` | string | Yes | - | Tagline shown on the call to action card, 2 to 40 characters. |
| `asset_id` | string or SelectItem | Yes | - | Main creative asset (audio, video or image) matching the ad set's asset\_format. Upload with spotify\_ads\_upload\_media or pick an existing asset from spotify\_ads\_list\_assets. |
| `logo_asset_id` | string or SelectItem | Yes | - | Image asset used as the logo on the call to action card. |
| `companion_asset_id` | string or SelectItem | No | - | Optional companion image asset shown alongside audio ads. |
| `canvas_asset_id` | string or SelectItem | No | - | Optional vertical 9:16 video or image asset. |
| `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, PRE\_SAVE. 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. |
| `clickthrough_url` | string | No | - | Landing page the call to action opens. |
| `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}. Example: \[\{"measurement\_partner": "IAS", "url": "`https://tracker.example.com`"}] |
| `catalog` | object or string | No | - | Catalog of things to be placed in a carousel type ad, sent as-is. Only for ad sets whose asset\_format is CATALOG. Shape: \{name, catalog\_items: \[...]} with 2 to 6 items. Each item takes asset\_id and clickthrough\_url (both required), tagline (2 to 40 characters, required), and optional sku, position, price and sale\_price objects of \{micro\_amount, currency\_code}. Example: \{"catalog\_items": \[\{"asset\_id": "uuid", "clickthrough\_url": "`https://example.com/item`", "tagline": "Artisan bowl", "price": \{"micro\_amount": 20000000, "currency\_code": "USD"}}]} |

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