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

> Creates a Snapchat Story ad from 1 to 20 snaps, with an optional Stories tab preview tile

Creates a Snapchat Story ad from 1 to 20 snaps, with an optional Stories tab preview tile. Requires a Snapchat Public Profile ID.

| | |
| - | - |
| **App** | Snapchat Ads |
| **Operation ID** | `snapchat_ads_create_story_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 all creatives (sent as profile\_properties.profile\_id). Required by Snapchat. |
| `ad_squad_id` | string or SelectItem | Yes | - | Snapchat ad squad ID to create the Story ad in. |
| `ad_name` | string | Yes | - | Name used for the ad and the composite creative. Max 375 characters. |
| `ad_status` | string or SelectableOption | No | `{'value': 'PAUSED', 'label': 'Paused'}` | Status when the ad is created: ACTIVE or PAUSED. Default: PAUSED. |
| `headline` | string | Yes | - | Headline displayed under the profile name, applied to the story and its snaps. 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. |
| `snaps` | array (also accepts a comma-separated string) | Yes | - | The snaps that make up the story, in display order (1 to 20 rows; the order is immutable after creation). Each row requires media\_url (image or video; 1080x1920; .mp4/.mov are treated as video). Optional per-row columns for a swipe-up attachment: attachment\_type (NONE, WEB\_VIEW, APP\_INSTALL, DEEP\_LINK), call\_to\_action, web\_view\_url, block\_preload, app\_name, ios\_app\_id, android\_app\_url, icon\_url, enable\_skoverlay, product\_page\_id, deep\_link\_uri, fallback\_type, web\_view\_fallback\_url. Example row: \{"media\_url": "`https://cdn.example.com/snap1.png`", "attachment\_type": "WEB\_VIEW", "web\_view\_url": "`https://example.com`", "call\_to\_action": "SHOP\_NOW"} |
| `preview_image_url` | string | No | - | Preview tile image for Story Ads running in the Stories tab (uploaded as preview\_properties.preview\_media\_id). Snapchat requires a 3:5 PNG, minimum 360x600, max 2MB. Required together with preview\_headline for Discover placement; omit for stories running between content. |
| `preview_headline` | string | No | - | Headline shown on the Story tile. Max 55 characters. Required when preview\_image\_url is set. |
| `logo_image_url` | string | No | - | Optional logo displayed on the Story tile (uploaded as preview\_properties.logo\_media\_id). |
| `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 Story ad, composite creative, and media IDs.

**Fields**: `ad_id`, `ad_name`, `creative_id`, `child_creative_ids`, `media_ids`, `status`


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