Create Single Image Ad - Markifact

Creates a Snapchat single image ad: uploads the image, creates the creative, then the ad. Supports swipe-up attachments and bulk creation. Requires a Snapchat Public Profile ID.


App	Snapchat Ads
Operation ID	`snapchat_ads_create_single_image_ad`
Type	Action
Connection	`snapchat_ads` (required)
Credits per run	3
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.
`update_type`	string or SelectableOption	Yes	-	Choose whether to create a single ad or multiple ads at once. Options: single or bulk.
`profile_id`	string or SelectItem	Yes	-	Snapchat Public Profile ID attached to the creative (sent as profile_properties.profile_id). Required by Snapchat for all new creatives. In bulk mode this is the default; rows can override it with a profile_id column.
`ad_squad_id`	string or SelectItem	No	-	Snapchat ad squad ID to create the ad in.
`ad_name`	string	No	-	Name used for the ad, the creative, 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.
`image_url`	string	No	-	Top snap image. Accepts a direct image URL, Google Drive share link (set to ‘Anyone with the link’), or Markifact uploaded image. Snapchat requires 1080x1920 PNG or JPG, max 5MB.
`headline`	string	No	-	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.
`attachment_type`	string or SelectableOption	No	`{'value': 'NONE', 'label': 'None (Snap Ad)'}`	What opens on swipe up. NONE creates a SNAP_AD creative (top snap only). WEB_VIEW creates a REMOTE_WEBPAGE ad opening web_view_url. APP_INSTALL creates an App Install ad (requires app_name, icon_url, and ios_app_id and/or android_app_url). DEEP_LINK opens deep_link_uri in your app (same app fields required).
`call_to_action`	string or SelectableOption	No	-	Call to action button text. Only used with an attachment. Valid values depend on attachment_type; for example WEB_VIEW allows SHOP_NOW, SIGN_UP, READ, VIEW_MENU; APP_INSTALL allows INSTALL_NOW, USE_APP, DOWNLOAD; DEEP_LINK allows OPEN_APP, VIEW_PROFILE, USE_APP.
`shareable`	boolean	No	`True`	Allow users to share the ad with friends. Default true.
`top_snap_crop_position`	string or SelectableOption	No	-	Image crop position: OPTIMIZED (Snapchat default), MIDDLE, TOP, or BOTTOM.
`web_view_url`	string	No	-	SSL-enabled URL opened on swipe up. Required when attachment_type is WEB_VIEW. Max 2048 characters.
`block_preload`	boolean	No	`False`	Block Snapchat from preloading the web view page. Default false.
`app_name`	string	No	-	Application name shown on the app install or deep link attachment. Max 30 characters. Required for APP_INSTALL and DEEP_LINK attachments.
`ios_app_id`	string	No	-	iOS App Store ID (for example 1234567890). At least one of ios_app_id or android_app_url is required for APP_INSTALL and DEEP_LINK attachments.
`android_app_url`	string	No	-	Google Play Store ID (for example com.snapchat.android).
`icon_url`	string	No	-	App icon image, uploaded to Snapchat as media (sent as icon_media_id). Snapchat requires a square PNG, ideally 256x256. Required for APP_INSTALL and DEEP_LINK attachments.
`enable_skoverlay`	boolean	No	`False`	Enable the iOS SKOverlay for the app attachment. Default false.
`product_page_id`	string	No	-	Optional iOS Custom Product Page ID (UUID).
`deep_link_uri`	string	No	-	Deep link URI opened in your app (for example myapp://product/123). Required when attachment_type is DEEP_LINK.
`fallback_type`	string or SelectableOption	No	-	Deep link fallback when the app is not installed: APP_INSTALL (Snapchat default) or WEB_SITE. WEB_SITE requires web_view_fallback_url.
`web_view_fallback_url`	string	No	-	Fallback web URL used with fallback_type WEB_SITE.
`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 (for example ad.doubleclick.net/ddm/trackimp).
`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 (for example ad.doubleclick.net/ddm/trackclk).
`return_detailed_results`	boolean	No	`False`	Bulk mode only. If true, returns per-row results and does not raise on partial failures.
`structured_data`	array (also accepts a comma-separated string)	No	-	Use only when update_type is bulk. Required columns: ad_squad_id, ad_name, image_url, headline. Optional columns: ad_status, brand_name, attachment_type, call_to_action, shareable, top_snap_crop_position, 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, profile_id, third_party_paid_impression_tracking_urls, third_party_on_swipe_tracking_urls.

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 created Snapchat ad, creative, and media IDs. Fields: ad_ids, creative_ids, media_ids, created_count