TOOL API

tcm_tt_video_apply

Applies for a creator's authorization to boost a TikTok video for a TikTok Creator Marketplace (TTCM) order or a TikTok One (TTO) Creator Marketplace campaign. The request must use an Access-Token authorized by a TikTok Creator Marketplace account or TTO Creator Marketplace account. This endpoint depends on prior TTCM or TTO Creator Marketplace setup: the video must already be linked to a TTCM order created via /tcm/order/create/v2/ or to a TTO Creator Marketplace campaign created via /tto/tcm/campaign/create/. Relevant video and account IDs can be obtained from related TTCM/TTO endpoints.

ecommerceOAuth1 credits

Call information

Tool slug
tiktok-ads.tcm_tt_video_apply
Provider
TikTok for Business
Average response
0 ms
Calls in 7 days
0

Input parameters

action

Action to take. `EXTEND` requests that an approved authorization be extended by the number of days in `authorization_days`; for example, if `authorization_days` is 30, the request asks to extend the authorization by 30 days.

authorization_days

Requested authorization validity period in days. Value range: 1-365. Default is 30. Use this field either to specify the validity period for a new authorization request or, when `action` is `EXTEND`, to request extending an approved authorization by the given number of days. The creator chooses the final approved validity period, so the actual validity period can differ from the requested value.

tcm_account_idrequired

TikTok Creator Marketplace account ID or TTO Creator Marketplace account ID. To obtain the TTO Creator Marketplace account IDs accessible with the provided `Access-Token`, use /tto/oauth2/tcm/.

video_idrequired

ID of a video created under the creator account. The video must be uploaded, tagged as branded content, and linked either to a TTCM order via the `invite_link` or `campaign_code` created through /tcm/order/create/v2/, or to a TTO Creator Marketplace campaign via the `invite_link` created through /tto/tcm/campaign/create/. You can obtain `video_id` from /tcm/order/get/v2/ or /tcm/report/get/v2/ for TTCM flows, and from /tto/tcm/campaign/ or /tto/tcm/report/ for TTO flows.