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