(5) Product status change

POST

The product status change webhook triggers when a product audit status changes or is completed:

• Product passes the first audit: PRODUCT_FIRST_PASS_REVIEW
• Product status changes by platform: PRODUCT_STATUS_CHANGED
• Product audit fails: PRODUCT_AUDIT_FAILURE

Authorizations

• webhookSignature

Request Body^required

Media typeapplication/json

object

type

required

The ID of the webhook type.

integer

Allowed value: 5

tts_notification_id

The ID of the notification.

string

shop_id

The shop ID.

string

timestamp

The Unix timestamp when the webhook was triggered.

integer format: int64

data

object

product_id

The identification of a TikTok Shop product

integer format: int64

status

Product audit status, with possible values:

• PRODUCT_FIRST_PASS_REVIEW
• PRODUCT_STATUS_CHANGED
• PRODUCT_AUDIT_FAILURE

string

Allowed values: PRODUCT_FIRST_PASS_REVIEW PRODUCT_STATUS_CHANGED PRODUCT_AUDIT_FAILURE

suspended_reason

The reason a product audit was rejected or frozen

string

update_time

The time when the status changed, represented as a Unix timestamp (seconds).

integer format: int64

Example

{
  "type": 5,
  "tts_notification_id": "7327112393057371910",
  "shop_id": "7494049642642441621",
  "timestamp": 1644412885,
  "data": {
    "product_id": 576486316948490000,
    "status": "PRODUCT_FIRST_PASS_REVIEW",
    "suspended_reason": "",
    "update_time": 1644412885
  }
}

Responses

200

Return HTTP 200 to acknowledge receipt.