Create Video Ad - Markifact

Creates TikTok video spark ads (native TikTok ads) with a single video and an optional thumbnail image, supports all campaign types: manual, smart+, search, etc.


App	TikTok Ads
Operation ID	`tiktok_ads_create_video_ad`
Type	Action
Connection	`tiktok_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 TikTok Ads account (advertiser) to create ads in
`update_type`	string or SelectableOption	Yes	-	Choose whether to create a single ad or multiple ads at once. Options: ‘single’ or ‘bulk’
`ad_group_id`	string or SelectItem	No	-	Select the TikTok ad group for this ad. Required for single ad creation.
`identity_id`	string or SelectItem	Yes	-	TikTok identity ID to use for the ads. Required for single and bulk ad creation. For this post ad operation, use a TikTok account identity (TT_USER) or a Business Center authorized TikTok identity (BC_AUTH_TT). Only provide the id, Markifact resolves the type automatically. Use the `tiktok_ads_list_identities` operation to find identity IDs user has access to.
`ad_name`	string	No	-	Name of the ad
`video_urls`	string or array of string	No	-	Video URLs to upload for this ad. Provide 1-50 videos. Smart+ ad groups support multiple video creatives; manual ad groups support 1 video. Supports direct video URLs and Google Drive share links.
`video_ids`	string or array of string	No	-	Optional existing TikTok video IDs. Provide 1-50 IDs to skip uploading video_urls.
`thumbnail_urls`	string or array of string	No	-	Optional thumbnail image URLs. Provide one per video. If omitted, TikTok auto-generates covers from the videos.
`thumbnail_ids`	string or array of string	No	-	Optional existing TikTok image IDs for thumbnails. Provide one per video to skip uploading thumbnail_urls.
`ad_texts`	string or array of string	No	-	TikTok ad texts. Manual ad groups support 1 text; Smart+ ad groups support up to 5 texts. Each text must be 100 characters or fewer.
`call_to_action`	string or SelectableOption	No	-	Optional TikTok call to action, for example LEARN_MORE, SHOP_NOW, SIGN_UP, CONTACT_US, DOWNLOAD.
`landing_page_url`	string	No	-	Landing page URL people open after clicking the ad. You can include UTM parameters, for example ?utm_source=tiktok&utm_id=CAMPAIGN_ID&utm_campaign=CAMPAIGN_NAME&utm_medium=paid. For app download campaigns, provide the app store URL. Optional when page_id is provided.
`page_id`	string	No	-	Optional TikTok page ID, such as an instant page, lead form, or other TikTok-hosted page. When provided, landing_page_url is optional and will not be sent to TikTok. Use the `tiktok_ads_list_pages` operation to find page IDs of any account.
`tracking_pixel_id`	integer or string	No	-	Optional TikTok tracking pixel ID. Usually inherited from the ad group for supported objectives; provide it manually if needed.
`tracking_app_id`	string	No	-	Optional TikTok tracking app ID. Usually inherited from the ad group for supported objectives; provide it manually if needed.
`disable_creative_enhancements`	boolean	No	`True`	Single mode only. Disable TikTok automatic creative enhancements. Default: true.
`is_dark_post`	boolean	No	`True`	Whether this ad should show as an ad only and not on your TikTok profile, otherwise, they will appear on your profile for anyone to see and engage with. Default: true which means `Only show as ads`.
`ad_status`	string or SelectableOption	No	-	Status when the ad is created. Options: ENABLE, DISABLE. Default: DISABLE.
`catalog_products`	string or array of string	No	-	Optional Smart+ catalog products. Use ‘ALL’ for all products, for example ‘ALL’. Use a product set ID string for a product set, for example ‘7636991234567890123’. Use a comma-separated string or list for specific products, for example ‘product_id_1,product_id_2’ or [‘product_id_1’, ‘product_id_2’]; TikTok allows max 20 product IDs.
`catalog_music_id`	string	No	-	Required when catalog_products is provided. Music ID for the catalog carousel creative, for example ‘6745887971053930498’.
`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_group_id, ad_name, ad_texts or ad_text_1/ad_text_2 numbered columns, landing_page_url or page_id, and videos. Videos can be provided as video_urls/video_ids lists, or numbered columns like video_1_url, video_2_url. Optional row columns: page_id, thumbnail_urls, thumbnail_ids, thumbnail_1_url, thumbnail_1_id, catalog_products, catalog_music_id, call_to_action, tracking_pixel_id, tracking_app_id, disable_creative_enhancements, is_dark_post, ad_status, or operation_status.

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 TikTok ad IDs, uploaded video IDs, thumbnail IDs (if any), created count, and creative details. Fields: ad_ids, video_ids, thumbnail_ids, created_count