Create TikTok Ad

Creates a TikTok ad (within an ad group). identity_id is REQUIRED (from list_tiktok_identities). Exactly ONE creative source is required: - tiktok_item_id — an ORGANIC TikTok post promoted as-is (Spark ad; get it from list_tiktok_posts, or reuse the one a running ad uses via list_tiktok_ads). The post supplies the video, caption and display name, so ad_text/display_name are not used on this path, and the identity must be the TikTok account that owns the post: TT_USER or BC_AUTH_TT (a business account authorised to the Business Center). The identity given is kept as-is; it is never swapped for another account. video_id: an uploaded video (list_tiktok_videos / upload_tiktok_video), with ad_text + landing_page_url. TikTok requires a cover image on a video ad: pass image_ids, or leave it empty and the video's own cover frame is uploaded and used automatically.

WHATSAPP (click-to-WhatsApp, "Instant messaging apps" destination; see create_tiktok_adgroup): in an ad group with messaging_app_type=IM_URL, whatsapp_number (with country code) and optional whatsapp_message (text pre-filled in the user's chat) make the ad's link https://wa.me/<number>?text=..., so tapping the ad opens WhatsApp directly with no website in between; a raw chat link in landing_page_url works too, and a website link is refused there. In ad groups with messaging_app_type WHATSAPP / MESSENGER / LINE / ZALO TikTok fills the destination from the ad group itself, so no link is sent on the ad (TikTok's rule). TikTok RETIRED custom (brand-name) identities: an ad now has to run under the account's own TikTok identity. For a BC_AUTH_TT identity TikTok also demands the Business Center id; it is resolved automatically when the account has exactly one Business Center, and identity_bc_id only has to be given when there are several. - image_ids — comma-separated uploaded images. identity_type: TT_USER (a real TikTok account), BC_AUTH_TT (a TikTok account authorised to the Business Center) or CUSTOMIZED_USER (name+avatar only, retired by TikTok); leave empty and the identity's own type is used. call_to_action: LEARN_MORE|SHOP_NOW|SIGN_UP|CONTACT_US|BOOK_NOW|... — use SEND_MESSAGE on Direct Message (messaging) ad groups. Starts DISABLE (paused). confirm=false is a preview, confirm=true applies.

landing_page_url is ignored for Direct Message (messaging) ad groups — there the destination is the chat itself.

auto_message_id: REQUIRED by TikTok for Direct Message (messaging) ad groups — the welcome-chat template the conversation starts with (list_tiktok_auto_messages / create_tiktok_auto_message). Leave empty and it is filled in automatically when the account has exactly one approved template.

ai_generated: TikTok has REQUIRED an AI-generated content disclosure since 21 July 2026; an undisclosed ad with AI-made visuals, voice or avatars is rejected. "auto" (default) turns the disclosure on when the uploaded video or image is recorded as AI-made. Pass "yes" when the creative was made with an AI tool, "no" only for real camera footage and photos.

automation: AUTO (default) reads the parent campaign and uses the matching endpoint — a Smart+ campaign refuses classic ad creation, so this is what lets an ad exist there at all; MANUAL or SMART_PLUS force one path. A Smart+ ad is MODULAR: the text, the call to action and the landing page are supplied as separate ingredients and TikTok assembles and tests the combinations itself. One difference to plan for: a Smart+ VIDEO ad also needs a cover image, so pass image_ids alongside video_id (the first image is used as the cover).