Create Collection Ad - Markifact

Creates a Snapchat Collection ad: a top snap with at least 4 tappable product thumbnails. Requires a Snapchat Public Profile ID.


App	Snapchat Ads
Operation ID	`snapchat_ads_create_collection_ad`
Type	Action
Connection	`snapchat_ads` (required)
Credits per run	4
Agent / MCP tool	Yes
Requires approval	Yes (write operation)

Inputs

Field	Type	Required	Default	Description
`account`	DynamicAccount	Yes	-	Select the Snapchat Ads account that owns the ad squad.
`profile_id`	string or SelectItem	Yes	-	Snapchat Public Profile ID attached to the creative (sent as profile_properties.profile_id). Required by Snapchat.
`ad_squad_id`	string or SelectItem	Yes	-	Snapchat ad squad ID to create the Collection ad in.
`ad_name`	string	Yes	-	Name used for the ad, the creative, the interaction zone, and the uploaded media. Max 375 characters.
`ad_status`	string or SelectableOption	No	`{'value': 'PAUSED', 'label': 'Paused'}`	Status when the ad is created: ACTIVE or PAUSED. Default: PAUSED.
`media_url`	string	Yes	-	Top snap media (image or video; .mp4/.mov are treated as video). Snapchat requires 1080x1920.
`headline`	string	Yes	-	Headline displayed under the profile name. Max 34 characters.
`brand_name`	string	No	-	Optional brand name override. Max 32 characters. When omitted, the Public Profile name is shown.
`shareable`	boolean	No	`True`	Allow users to share the ad with friends. Default true.
`thumbnails`	array (also accepts a comma-separated string)	Yes	-	The tappable product thumbnails shown under the top snap, in order. At least 4 rows. Each row requires image_url (square PNG, minimum 120x120, max 2MB) and url (https landing page opened when the thumbnail is tapped). Example row: {“image_url”: “`https://cdn.example.com/product1.png`”, “url”: “`https://shop.example.com/product1`”}
`interaction_zone_headline`	string or SelectableOption	No	`{'value': 'MORE', 'label': 'More'}`	Headline shown on the interaction zone. Uses the Web View call to action values, for example MORE, SHOP_NOW, VIEW_MENU. Default: MORE.
`fallback_url`	string	Yes	-	https URL opened when the user swipes up on the full unit instead of tapping a thumbnail (sent as the WEB_VIEW default fallback interaction).
`third_party_paid_impression_tracking_urls`	string or array of string	No	-	Third-party impression tracking tags, executed on ad impression. List of https URLs from Snapchat-approved domains.
`third_party_on_swipe_tracking_urls`	string or array of string	No	-	Third-party swipe tracking tags, executed on swipe up. List of https URLs from Snapchat-approved domains.

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.

SelectableOption

Field	Type	Required	Default	Description
`value`	string	Yes	-
`label`	string	Yes	-

Output

Type: Dict Returns the created Collection ad, creative, interaction zone, and media IDs. Fields: ad_id, ad_name, creative_id, interaction_zone_id, creative_element_ids, media_ids, status