快工助手跨境电商知识与商机助手

For All markets:New Republish Activity API

TikTok Shop 官方资料 · TikTok Shop Partner Center 开发者文档 · 适合开发者

stable本次发布有变化全部展示

来自 TikTok Shop 官方资料快照 ·

打开官方原文 ↗
  1. 当前资料结构化阅读页
  2. 固定快照已留存,可追溯
  3. 官方原文可核对
查看技术与溯源信息
平台 / profile
TikTok Shop / profile.tiktok.docs_api
语言
en-US
发布版本
cn-20260909-2
标签
zhuge/sourceplatform/tiktok_shopaudience/developercategory/api_doctopic/compliancetopic/developer

资料正文

§1 Summary

The Promotion category adds a new Republish Activity API that lets sellers bring an expired or deactivated promotion activity (product discount or flash deal) back online for a new effective period. There is no need to recreate the activity or re-associate products and SKUs — promotions can be restored in a single call.

#

§2 Value & Use Cases

Value & Use Cases

  • Lower cost, higher efficiency: Previously, restoring an expired activity meant recreating it and re-adding every product/SKU one by one — many calls, tedious work. The new API reuses the products and SKUs already tied to the original activity and only requires a new effective period, significantly cutting the number of add-products calls.
  • Typical scenarios: Extending or reopening a promotion after it expires (e.g., mega-sale returns, flash-deal renewals); quickly recovering an activity that was deactivated by mistake; running periodic, rolling promotions on the same set of products.
  • After republishing, the activity can be edited as usual — you can continue to add or remove products and SKUs.
#

§3 Scope of Impact

  • New endpoint:POST /promotion/202607/activities/{activity_id}/republish
  • Supported activity types: Only FIXED_PRICE, FLASHSALE, and DIRECT_DISCOUNT activities.
  • Applicable seller types: both local and cross-border.
  • Preconditions: The target activity must have expired or been deactivated within the last 7 days; begin_time must be greater than the current time; otherwise error code 17003243 (This activity dont allow republishing) is returned.
#

§4 Works With / Replaces

  • Before: Search Promotion Activities / Get Activity — locate the target activity_id and its status.
  • After (optional): Update Promotion Activity / Update Promotion Activity Products / Remove Promotion Activity Products — adjust the activity and its products as needed once republished.
  • Replaces: The old flow of recreate activity + Create Promotion Activity + re-add products one by one. TikTok Shop recommends using this API instead to reduce API requests.
#

§5 Timeline

  • Effective version: 202607; launch: 2026-07.
  • RC / preview version: None.
#

§6 Quick Start

Integration: standard TTS signed authentication (app_key + sign + timestamp), pass x-tts-access-token in the header (seller access_token where user_type=0); cross-border shops must pass shop_cipher in the query. Request sample:

POST /promotion/202607/activities/{activity_id}/republish?app_key={app_key}&sign={sign}&timestamp={timestamp}&shop_cipher={shop_cipher}
Content-Type: application/json
x-tts-access-token: {access_token}

{
  "begin_time": 1784538000,
  "end_time": 1785142800
}

Success response sample (data.activity_id is the ID of the successfully republished activity):

{
  "code": 0,
  "data": {
    "activity_id": "7136104329798256386"
  },
  "message": "Success",
  "request_id": "202203070749000101890810281E8C70B7"
}
#