TOOL API
tt_
Applies a creator-provided authorization code to connect an ad account with a Spark Ads post. Getting a code from the post owner does not automatically enable authorization; you must call this endpoint to put the authorization into effect. If the post is a duet or stitch of another post, or mentions another video, you must obtain authorization from both post owners before promoting it: use `auth_code` for the promoted post and `original_post_auth_code` for the original post. In v1.3, the endpoint path is `/v1.3/tt_video/authorize/`; compared with v1.2, the request parameter `from_auth_code` was renamed to `original_post_auth_code`, and `advertiser_id` changed from number to string.
Call information
- Tool slug
- tiktok-ads.tt_video_authorize_apply
- Provider
- TikTok for Business
- Average response
- 0 ms
- Calls in 7 days
- 0
Input parameters
advertiser_idrequiredAdvertiser ID.
auth_coderequiredAuthorization code for the Spark Ads post. Replace any `+` characters in the code with `%2B`; otherwise you may get an invalid authorization code error. When the post is a duet, stitch, or mentions another video, this field is still used for the promoted post's authorization code, while `original_post_auth_code` must contain the original post owner's authorization code.
original_post_auth_codeAuthorization code for the original post owner. Required when the post is a duet or stitch of another post, or when it mentions another video. The post can currently mention at most one video.