TikTok Ads

List TikTok identities the ads can post as

Lists the identities this advertiser can run ads as — the handle and avatar a viewer sees on the ad — including the custom identities created in Ads Manager and any TikTok accounts authorised through Business Center. Use when: creating any ad, and always before a Spark Ad. A Spark Ad runs as the account that posted the original video, so it needs that account's identity id and its permission; without both, the create fails. Do not pick an identity for the user when several exist. Which account an ad appears as is a brand decision and a legal one — ask. Returns can_push_video, which is what distinguishes an identity that can carry a real TikTok post from a display-only custom identity, and the Business Center id a BC_AUTH_TT identity needs passed as identity_authorized_bc_id. TikTok no longer accepts new ads that post as a custom identity (CUSTOMIZED_USER) on placements that include TikTok, so offer a TikTok account identity. Costs nothing, and the answer rarely changes, so read it once per launch rather than per ad.

post/api/v1/tools/tiktok_list_identities/execute

Request

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