TikTok Ads

Add an ad to a TikTok ad group (paused)

Creates one more ad inside an existing TikTok ad group, PAUSED, from a video already in the library or an organic post (Spark Ad). Use when: testing a second creative, or replacing one that tiktok_detect_creative_fatigue has flagged. Adding a fresh ad to a working ad group is the right way to handle fatigue: it keeps the ad group's learning, which pausing and rebuilding would throw away. Do not upload a video here — this tool takes a video_id. Upload happens in tiktok_create_video_campaign, or the user uploads in Ads Manager and tiktok_list_ad_videos finds the id. Do not add more than two or three ads to one ad group. TikTok concentrates delivery on whichever wins early, so extra ads mostly divide the learning rather than expand the test. Do not guess the identity. TikTok requires one on every ad; list them with tiktok_list_identities and ask the user which account the ad appears as. A video_id ad also needs exactly one cover image (tiktok_upload_images). Do not assume the new ad delivers immediately: it is created paused and, once resumed, TikTok reviews it first — usually a few hours. Validates before creating: the identity (it must exist on the advertiser, 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 landing page the campaign's objective requires. Returns the new ad id, read back from TikTok with its review status.

post/api/v1/tools/tiktok_add_ad/execute

Request

  • Base URL: https://adako.ai
  • URL: https://adako.ai/api/v1/tools/tiktok_add_ad/execute
  • Auth: HTTP bearer

Headers

Idempotency-Keystring

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.

successunknown required
toolstring required
dataobject required

Machine-readable result.

markdownstring required

The same result written for a person or a model.

proposal_idstring

Present for writes. Nothing changes on the ad platform until it is approved.

approve_urlstring

Where a person approves the proposal.

request_idstring required

Changes

No recorded changes to this operation across all 1 revision of this API.