TOOL API

tto_tcm_campaign_link

Sends a request to link a creator's public video to a TikTok One (TTO) Creator Marketplace campaign, or revokes an existing linking request. This endpoint requires an Access-Token authorized by a TikTok One Creator Marketplace account. To use it, you need a TTO Creator Marketplace account ID from `/tto/oauth2/tcm/`, a campaign ID from `/tto/tcm/campaign/`, and a creator video ID from `/tcm/creator/authorized/video/list/`.

ecommerceOAuth1 credits

Call information

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

Input parameters

actionrequired

Action to perform. `LINK`: send a linking request to the creator for the specified `video_id` and `campaign_id`. If a request was already sent, using `LINK` sends a reminder notification instead. After sending a linking request, you must wait 24 hours before sending a reminder, or an error occurs. You can send up to two reminder notifications for one linking request. `REVOKE`: revoke the linking request for the specified `video_id` and `campaign_id`. Valid only when the creator has not accepted or rejected the request. Each linking request can be revoked only once.

campaign_idrequired

ID of an existing TTO Creator Marketplace campaign. To obtain campaign IDs, use `/tto/tcm/campaign/`.

tto_tcm_account_idrequired

ID of the TikTok One Creator Marketplace account. To obtain the account IDs accessible by the `Access-Token`, use `/tto/oauth2/tcm/`.

video_idrequired

ID of the creator's public video to link to the campaign. To obtain video IDs, use `/tcm/creator/authorized/video/list/`. Videos already linked to any other TikTok Creator Marketplace campaign or TTO Creator Marketplace campaign are not supported. The video's creator must already have been invited to the specified campaign.