TikTok Ads tools

TikTok ad accounts (advertisers) reachable with the connected TikTok Ads token: id, name, currency, timezone, status. Read only; returns connected=false when no account is linked.

This tool takes no parameters.

TikTok campaigns of the connected ad account: campaign_id, name, objective_type, budget, budget_mode, operation_status. Use campaign_id values for the other tiktok tools.

TikTok ad groups with budget, bid, optimisation goal, targeting (locations, ages, gender, languages, interests, audiences), placements, schedule and dayparting.

TikTok ads: ad_id, name, ad group, status, format, text, video_id, landing page, call to action.

TikTok performance by campaign, ad group or ad for a date range: spend, impressions, clicks, CTR, CPM, CPC, conversions, cost per conversion, conversion rate, ROAS where available; optional daily breakdown and totals. Real data only; connected=false when no account.

Custom and lookalike audiences of the TikTok ad account: audience_id, name, type, size (cover_num), validity. Use audience_ids in update_tiktok_ad_group to assign them.

This tool takes no parameters.

Videos in the TikTok ad account's asset library: video_id, file name, duration, size, preview and cover URLs. Use video_id in create_tiktok_ad or create_tiktok_whatsapp_campaign; add new videos from a public URL with upload_tiktok_video.

Suggested cover frames for a TikTok library video (file/video/suggestcover): id, preview url (valid one hour), size. Upload the chosen url with upload_tiktok_image to use it as the ad cover (image_ids). Read only.

Turn targeting names into TikTok ids: interest (tool/interest_category → interest_category_ids), behavior (tool/action_category → actions[].action_category_ids), interest_keyword (tool/interest_keyword/recommend → interest_keyword_ids), location (tool/targeting/search → location_ids / zipcode_ids, cities and provinces), region (tool/region → targetable countries for the objective). Read only.

Upload a video to the TikTok ad account's asset library from a public URL (file/video/ad/upload, UPLOAD_BY_URL). Preview and approval first; the new video_id is returned in the action result.

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

Upload an image (image ad or video cover) to the TikTok asset library from a public URL (file/image/ad/upload, UPLOAD_BY_URL). Preview and approval first; the image_id is returned in the action result.

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

Create a TikTok campaign end to end (campaign + ad group, optionally the ad) as a paused draft. Writes a ledger draft and opens an approval item with a preview; sent to TikTok only after approval and only with a connected account.

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

Create a TikTok ad group under a campaign with budget, bid, targeting, placements, schedule and dayparting. Preview and approval first; created paused unless operation_status=ENABLE.

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

Create a TikTok ad in an ad group from a library video (or Spark post). Preview and approval first.

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

Change the budget of one or more TikTok campaigns. Goes through preview and approval; the ledger is updated only when TikTok accepts.

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

Pause (DISABLE) or enable (ENABLE) TikTok campaigns. Preview and approval first.

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

Update one or many TikTok ad groups at once: budget, bid (bid_type/bid_price), targeting (locations, ages, gender, languages, interests, audiences), schedule and dayparting, comment/share settings. Placements and budget mode cannot change after creation (TikTok rule). Preview and approval first.

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

Pause or enable TikTok ad groups (e.g. the ones whose CPA is above target). Preview and approval first.

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

Pause or enable TikTok ads (e.g. a fatigued creative). Preview and approval first.

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

Create a rule-based TikTok custom audience from pixel, app or engagement events (e.g. added to cart in the last 30 days but did not purchase). Preview and approval first; the audience needs hours to populate.

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

Create a TikTok lookalike audience from a custom audience (TikTok sizes: NARROW ≈ closest, BALANCED, BROAD). Preview and approval first.

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

Create a TikTok ad that opens a WhatsApp chat (click-to-WhatsApp): LEAD_GENERATION campaign, ad group with optimisation location Instant Messaging App (WhatsApp) on TikTok placement, and a video ad whose cover is taken from the video automatically. chat_link builds the wa.me link from the phone number; website URLs are refused. Everything is created paused; preview and approval first.

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.