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. |
music_id | string | No | - | Single mode only. TikTok music ID to use for the image ad. Required for TikTok image ads. Use a music ID from TikTok’s available music API or from an existing TikTok ad returned by ad/get. |
ad_name | string | No | - | Name of the ad |
image_urls | string or array of string | No | - | Image URLs to upload for this ad. Provide 1-35 images. One image creates a single image ad; multiple images create a carousel image ad. Supports direct image URLs and Google Drive share links. |
image_ids | string or array of string | No | - | Optional existing TikTok image IDs. Provide 1-35 IDs to skip uploading image_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 | - | 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. |
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, music_id, ad_texts or ad_text_1/ad_text_2 numbered columns, landing_page_url or page_id, and images. Images can be provided as image_urls/image_ids lists, or numbered columns like image_1_url, image_2_url. Optional row columns: page_id, call_to_action, tracking_pixel_id, tracking_app_id, disable_creative_enhancements, is_dark_post, ad_status, or operation_status. |
