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