Create TikTok Ad Group

Creates a TikTok ad group — targeting/budget/billing event. Starts DISABLED (paused). location_ids REQUIRED (comma-separated; from tiktok_region_search). optimization_goal: CLICK|CONVERT|REACH|VIDEO_VIEW|LEAD_GENERATION|CONVERSATION|... billing_event: CPC|CPM|OCPM|CPV. optimization_goal=CONVERSATION sets up TikTok Direct Message (messaging) ad groups: promotion_type defaults to LEAD_GEN_CLICK_TO_TT_DIRECT_MESSAGE, billing_event to OCPM and optimization_event to MESSAGE automatically; no pixel is needed. age_groups: AGE_18_24,AGE_25_34... genders: GENDER_MALE|GENDER_FEMALE. For CONVERT, pixel_id + optimization_event are required. placements (optional, comma-separated): PLACEMENT_TIKTOK,PLACEMENT_PANGLE,PLACEMENT_GLOBAL_APP_BUNDLE — leave empty for TikTok's automatic placement. schedule_start / schedule_end: 'YYYY-MM-DD HH:MM:SS' in the ad account's timezone — leave schedule_start empty to start now, schedule_end empty to run open-ended. search_result_enabled=true also serves on TikTok Search results. promotion_type (what is being advertised — TikTok requires it): WEBSITE|APP_ANDROID|APP_IOS|LEAD_GEN_INSTANT_FORM|LEAD_GEN_CLICK_TO_CALL|LEAD_GEN_CLICK_TO_TT_DIRECT_MESSAGE|LEAD_GEN_CLICK_TO_SOCIAL_MEDIA_APP_MESSAGE|LEAD_GEN_EXTERNAL_WEBSITE|FOLLOWERS|LIVESTREAM. INSTANT MESSAGING APPS (WhatsApp / Messenger / LINE / Zalo, per TikTok's official API guide "Create a Lead Generation ad with optimization location as instant messaging apps"): campaign objective LEAD_GENERATION + promotion_type=LEAD_GEN_CLICK_TO_SOCIAL_MEDIA_APP_MESSAGE, then messaging_app_type (cannot be changed later): IM_URL (default) = a custom chat link set on each ad (https://wa.me/<number> via create_tiktok_ad(whatsapp_number=...)), works with no extra setup, CLICK only; WHATSAPP = TikTok fills the chat from messaging_phone (international format; phone_region_code only when the calling code is shared, like +1), but TikTok requires that number to be connected to its Messaging Management Tool (MMT); MESSENGER = messaging_app_account_id is the Facebook Page ID; LINE = messaging_app_account_id is the LINE Business ID (CLICK only); ZALO = messaging_phone (CLICK only). optimization_goal CONVERSATION is allowlist-only at TikTok and only for MESSENGER/WHATSAPP. BUDGET MINIMUMS: TikTok sets the ad group daily minimum per currency (base 20 USD, converted with each currency's budget ratio); when a budget is too low TikTok's error states the exact minimum for that account's currency. Empty for website campaigns (TRAFFIC/REACH/VIDEO_VIEWS/ENGAGEMENT/WEB_CONVERSIONS) derives it from the campaign objective; app/catalog/lead-form campaigns take it explicitly. bid_type: BID_TYPE_NO_BID (automatic bidding, default) | BID_TYPE_CUSTOM (manual bid; bid_price required, in the account currency). pacing: PACING_MODE_SMOOTH (standard delivery, default; spreads the budget over the day) | PACING_MODE_FAST (accelerated; only valid with BID_TYPE_CUSTOM, TikTok rejects it with automatic bidding). automation: AUTO (default) reads the campaign and uses the matching endpoint (TikTok refuses classic ad-group creation inside a Smart+ campaign, so this is what makes an ad group possible there at all); MANUAL or SMART_PLUS force one path. In a Smart+ ad group TikTok requires a real placement list (automatic placement is rejected, so PLACEMENT_TIKTOK is used when none is given) and treats the targeting as a starting point it can widen; pacing and search_result_enabled do not apply. confirm=false previews, confirm=true applies.