Create a TikTok video campaign (paused)
Builds a complete TikTok campaign — campaign, one ad group and one in-feed video ad — from a video URL, an existing video id, or an organic post for a Spark Ad. The campaign is created PAUSED and its ad group and ad enabled inside it, so nothing spends until the campaign is turned on, and turning it on launches everything. Use when: the user wants a new TikTok campaign and has given the pieces: what it should achieve, a daily budget, where it should run, the video, the TikTok account the ad should appear as, and (for a video) a cover image. Resolve every place, language and interest with tiktok_search_targeting first, pick the identity with tiktok_list_identities, and confirm the objective with tiktok_explain_objective — this tool takes ids and refuses names. Do not call it twice for the same campaign. It creates three objects and Adako has no delete tool: a duplicate must be paused and abandoned by hand. If a call fails, read the error — it names exactly which objects were created before the failure — and fix forward rather than retrying. Do not invent a budget, an audience, an identity or a landing page. If the user has not named one, ask. Do not use a WEB_CONVERSIONS objective without checking tiktok_list_pixels: optimising for an event that is not firing burns the budget in the learning phase and never settles. What it validates before creating anything: the objective / optimisation goal / billing combination, the campaign and ad group budget range and precision for the account's currency, the bid against its limits and both budgets, the schedule (days are the advertiser's, and a start more than a few hours in the past is refused), the pixel and event when the objective needs them, every location id against TikTok's list (including overlaps and the under-18 rules), the language codes, the identity (it must exist, be available, and be able to carry the post), the cover image, the ad text (no emoji; Chinese and Japanese characters count double), and the video itself — which is uploaded and read back from TikTok first, so a video that is too short never leaves a campaign behind. Returns the campaign, ad group and ad ids, read back from TikTok, plus what to do next. Say explicitly that the campaign is paused when you report the result, with the two links the result gives (TikTok Ads Manager and the campaign's page in Adako), and offer "enable all": one tiktok_resume_campaign call, listed in the result as go_live.enable_all, one approval. TikTok also reviews the ad before it delivers, which usually takes a few hours.
Request
- Base URL: https://adako.ai
- URL: https://adako.ai/api/v1/tools/tiktok_create_video_campaign/execute
- Auth: HTTP bearer
Headers
Optional 8-128 character key. A successful envelope is cached for 24 hours; replaying the key with the same arguments returns it again with Idempotent-Replayed: true, and replaying it with different arguments answers 409.
Request body
Response
The tool ran. A write returns proposal_id and approve_url while the change waits for approval.
Changes
No recorded changes to this operation across all 1 revision of this API.