Create Ad - Markifact

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