(56) Sample Application Status Change

POST

This webhook will trigger when the creator’s sample application status changes.

Authorizations

• webhookSignature

Request Body^required

Media typeapplication/json

object

type

required

The ID of the webhook type.

integer

Allowed value: 56

tts_notification_id

The ID of the notification.

string

shop_id

TikTok shop ID

string

timestamp

The UNIX timestamp when this webhook was triggered.

integer format: int64

data

object

application_id

The id of the sample application

string

new_status

The status of sample applications. The possible enumerated values are:

• PENDING: The sample application is waiting for the seller’s review.
• AWAITING_SHIPMENT: The application is approved, and the seller needs to ship the sample.
• SHIPPED: The sample has been shipped by the seller and is waiting for the creator to receive the package.
• CONTENT_PENDING: The creator has received the sample package and is expected to create content.
• REJECT_CANCELLED: The sample application has been rejected by the seller.
• OVERDUE_CANCELLED: The sample application has expired due to being overdue.
• UNFULFILL_CANCELLED: The creator did not fulfill the commitment to create content within the agreed timeframe.
• DEL_OPEN_COLLAB: Open collaboration has been deleted.
• SELLER_NOT_SHIP_CANCELLED: The seller did not ship the sample within the required timeframe.
• WITHDRAW_CANCELLED: The creator withdrew the sample application before the seller approved it.
• UNFULFILLABLE_CANCELLED: The application was cancelled due to reasons beyond the creator’s control, making it impossible to create content.
• OPS_CANCELLED: The application was manually cancelled by operations staff.
• OPS_FAILED: The application was marked as failed by operations staff.
• OPS_COMPLETED: The application was manually marked as completed by operations staff.
• COMPLETED: The application is complete, and the creator has posted the content.

This field allows for tracking the status of a sample application throughout its lifecycle, providing visibility into each stage of the process for sellers and creators.

string

Allowed values: PENDING AWAITING_SHIPMENT SHIPPED CONTENT_PENDING REJECT_CANCELLED OVERDUE_CANCELLED UNFULFILL_CANCELLED DEL_OPEN_COLLAB SELLER_NOT_SHIP_CANCELLED WITHDRAW_CANCELLED UNFULFILLABLE_CANCELLED OPS_CANCELLED OPS_FAILED OPS_COMPLETED COMPLETED

creator

Creator detailed information. It includes various details such as the creator’s TikTok user name and TikTok user id.

Array<object>

object

creator_open_id

Creator Open ID. More details

string

product

Product information.

Array<object>

object

id

The product identifier.

string

sku_id

The unique id of product sku which the creator applied for as a sample.

string

Responses

200

Return HTTP 200 to acknowledge receipt.