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. |
