TikTok Ads

Edit a TikTok ad group

Changes a TikTok ad group's name, daily budget, bid, schedule or targeting (locations, ages, gender, languages, interests). Use when: the user wants to scale, narrow or reschedule an existing ad group. Resolve every location, language and interest with tiktok_search_targeting first — this tool takes ids and refuses names. Do not treat targeting fields as additive. TikTok replaces them wholesale: passing one location id to an ad group targeting five leaves it targeting one. The preview always shows the full before and after for exactly that reason — read it to the user before they approve. Do not change budget or bid by more than about 30% at a time: TikTok restarts the learning phase after a large move and performance dips for days. The tool warns when a change crosses that line. TikTok also refuses a budget below 105% of what the ad group has spent today, and a bid that is not below both the ad group and campaign budgets; both are checked first. Do not set a manual bid on an ad group that is bidding automatically unless the user asked for a cap and understands the risk — a cap below the market price stops delivery silently, with no error anywhere. Dates are the advertiser's days. Moving the start of an ad group that has already started is refused (TikTok does not allow it); changing only the end date keeps the start, and changing only the start keeps an existing end date. Returns the ad group read back from TikTok after the change. At least one field must be given.

post/api/v1/tools/tiktok_update_ad_group/execute

Request

  • Base URL: https://adako.ai
  • URL: https://adako.ai/api/v1/tools/tiktok_update_ad_group/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.