(18) Product category change

POST

When the category of a product is changed, all apps authorized by the shop (using shop_id) receive this webhook. When you receive the webhook, you can get more detailed product information by using the Get Product API. This webhook is triggered regardless of how a product category is changed. Categories can be changed by the seller, developer, or TikTok Shop.

Authorizations

• webhookSignature

Request Body^required

Media typeapplication/json

object

type

required

The ID of the webhook type.

integer

Allowed value: 18

tts_notification_id

The ID of the notification.

string

shop_id

The ID of the shop.

string

timestamp

The time when this webhook was triggered, represented by Unix timestamp.

integer format: int64

data

object

product_id

ID of the product promoted in the creator’s video.

string

previous_category_id

The category ID of the product before the category update.

string

current_category_id

The category ID of the product after the category update.

string

update_time

The time when this category update happens, represented by Unix timestamp.

integer format: int64

Example

{
  "type": 18,
  "shop_id": "7494049642642441621",
  "tts_notification_id": "7327112393057371910",
  "timestamp": 1644412885,
  "data": {
    "product_id": "789078671231",
    "previous_category_id": "600001",
    "current_category_id": "600002",
    "update_time": 1644412845
  }
}

Responses

200

Return HTTP 200 to acknowledge receipt.