stable本次发布有变化全部展示
来自 TikTok Shop 官方资料快照 ·
- 当前资料结构化阅读页
- 固定快照已留存,可追溯
- 官方原文可核对
资料正文
§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}×tamp={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"
}
§7 Links
- API Reference: Republish Activity
- Quick Start / Overview: Promotion API Overview
