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

> Creates a Snapchat Collection ad: a top snap with at least 4 tappable product thumbnails

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** | 1 |
| **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`


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