TikTok Ads

Upload cover images to TikTok

Uploads one or more images to the advertiser's creative library from public URLs and returns their image ids, which tiktok_add_ad and tiktok_create_video_campaign take as the ad's cover. Use when: the user wants a specific frame as the ad's cover rather than the one TikTok picks. Validate the URLs with tiktok_validate_assets first — it is free and catches the failures this cannot recover from. Do not use it for videos: video upload happens inside tiktok_create_video_campaign, which needs to attach the result to an ad in the same operation. Do not re-upload an image that is already in the library; check tiktok_list_ad_videos' sibling library in Ads Manager, or reuse the image id from an existing ad via tiktok_list_ads. Uploading changes nothing that spends money — it adds files to a library — but it is a write, so it goes through the proposal engine like every other write and is never repeated on a retry. Returns the image ids, dimensions and sizes TikTok recorded.

post/api/v1/tools/tiktok_upload_images/execute

Request

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