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 |
post_ids | string or array of string | No | - | Existing TikTok post IDs to use for this ad. Manual ad groups support 1 post; Smart+ ad groups support up to 50 post creatives. |
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. |
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, landing_page_url or page_id, and posts. Posts can be provided as post_ids lists or numbered columns like post_1_id, post_2_id. Optional row columns: page_id, call_to_action, tracking_pixel_id, tracking_app_id, disable_creative_enhancements, ad_status, or operation_status. |