TikTok Shop webhook events
17 TikTok Shop event types in 4 resources, plus Other TikTok Shop events. 16 have sample payloads.
Every event here can also reach agents as an MCP event through Hookdeck: MCP events →
fulfillment
RECIPIENT_ADDRESS_UPDATE
documented from TikTok Shop docs (example)
RECIPIENT_ADDRESS_UPDATE Recipient's address on an order is updated
Identified by type field in the body, a number rather than the event name
Resource fulfillment
{
"type": 3,
"shop_id": "7494049642642441621",
"timestamp": 1644412885,
"data": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
type | integer | 3 |
timestamp | integer | 1644412885 |
Full schema: 6 fields.
From TikTok Shop docs
-
Content type
application/json
PACKAGE_UPDATE
documented from TikTok Shop docs (example)
PACKAGE_UPDATE Package is combined, split or otherwise changed
Identified by type field in the body, a number rather than the event name
Resource fulfillment
{
"type": 4,
"tts_notification_id": "7327112393057371910",
"shop_id": "7494049642642441621",
"timestamp": 1644412885,
"data": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
type | integer | 4 |
timestamp | integer | 1644412885 |
Full schema: 13 fields.
From TikTok Shop docs
-
Content type
application/json
INVOICE_STATUS_CHANGE
documented from TikTok Shop docs (example)
INVOICE_STATUS_CHANGE Invoice upload changes status, in the Brazil market only
Identified by type field in the body, a number rather than the event name
Resource fulfillment
{
"type": 36,
"tts_notification_id": "7327112393057371910",
"shop_id": "7494049642642441621",
"timestamp": 1644412885,
"data": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
type | integer | 36 |
timestamp | integer | 1644412885 |
Full schema: 10 fields.
From TikTok Shop docs
-
Content type
application/json
messages
NEW_CONVERSATION
documented from TikTok Shop docs (example)
NEW_CONVERSATION Customer service agent joins or leaves a conversation
Identified by type field in the body, a number rather than the event name
Resource messages
{
"type": 13,
"tts_notification_id": "7327112393057371910",
"shop_id": "7494049642642441621",
"timestamp": 1644412885,
"data": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
type | integer | 13 |
timestamp | integer | 1644412885 |
Full schema: 7 fields.
From TikTok Shop docs
-
Content type
application/json
NEW_MESSAGE
documented from TikTok Shop docs (example)
NEW_MESSAGE Message is sent in a customer service conversation
Identified by type field in the body, a number rather than the event name
Resource messages
{
"type": 14,
"tts_notification_id": "7327112393057371910",
"shop_id": "7494049642642441621",
"timestamp": 1644412885,
"data": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
type | integer | 14 |
timestamp | integer | 1644412885 |
Full schema: 15 fields.
From TikTok Shop docs
-
Content type
application/json
NEW_MESSAGE_LISTENER
documented from TikTok Shop docs (example)
NEW_MESSAGE_LISTENER Creator sends the seller a message
Identified by type field in the body, a number rather than the event name
Resource messages
{
"type": 33,
"shop_id": "7494049642642441621",
"tts_notification_id": "7327112393057371910",
"timestamp": 1644412885,
"data": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
type | integer | 33 |
timestamp | integer | 1644412885 |
Full schema: 13 fields.
From TikTok Shop docs
-
Content type
application/json
order
ORDER_STATUS_CHANGE
documented from TikTok Shop docs (example)
ORDER_STATUS_CHANGE Order is placed or its status changes
Identified by type field in the body, a number rather than the event name
Resource order
{
"type": 1,
"tts_notification_id": "7380066284010030890",
"shop_id": "7495540735365777507",
"timestamp": 1718305585,
"data": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
type | integer | 1 |
timestamp | integer | 1718305585 |
Full schema: 9 fields.
CANCELLATION_STATUS_CHANGE
documented from TikTok Shop docs (example)
CANCELLATION_STATUS_CHANGE Order's cancellation request changes status
Identified by type field in the body, a number rather than the event name
Resource order
{
"type": 11,
"tts_notification_id": "7327112393057371910",
"shop_id": "7494049642642441621",
"timestamp": 1644412885,
"data": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
type | integer | 11 |
timestamp | integer | 1644412885 |
Full schema: 10 fields.
From TikTok Shop docs
-
Content type
application/json
RETURN_STATUS_CHANGE
documented from TikTok Shop docs (example)
RETURN_STATUS_CHANGE Order's return, refund or replacement request changes status
Identified by type field in the body, a number rather than the event name
Resource order
{
"type": 12,
"tts_notification_id": "7327112393057371910",
"shop_id": "7494049642642441621",
"timestamp": 1644412885,
"data": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
type | integer | 12 |
timestamp | integer | 1644412885 |
Full schema: 12 fields.
From TikTok Shop docs
-
Content type
application/json
REVERSE_STATUS_UPDATE
documented No payload yet
REVERSE_STATUS_UPDATE Buyer's cancellation, refund or return request needs the seller's decision
Identified by type field in the body, a number rather than the event name
Resource order
No payload yet.
product
PRODUCT_STATUS_CHANGE
documented from TikTok Shop docs (example)
PRODUCT_STATUS_CHANGE Product passes or fails audit, or the platform changes its status
Identified by type field in the body, a number rather than the event name
Resource product
{
"type": 5,
"tts_notification_id": "7327112393057371910",
"shop_id": "7494049642642441621",
"timestamp": 1644412885,
"data": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
type | integer | 5 |
timestamp | integer | 1644412885 |
Full schema: 9 fields.
From TikTok Shop docs
-
Content type
application/json
PRODUCT_INFORMATION_CHANGE
documented from TikTok Shop docs (example)
PRODUCT_INFORMATION_CHANGE Edits to a live product take effect
Identified by type field in the body, a number rather than the event name
Resource product
{
"type": 15,
"tts_notification_id": "7327112393057371910",
"shop_id": "7494049642642441621",
"timestamp": 1644412885,
"data": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
type | integer | 15 |
timestamp | integer | 1644412885 |
Full schema: 10 fields.
From TikTok Shop docs
-
Content type
application/json
PRODUCT_CREATION
documented from TikTok Shop docs (example)
PRODUCT_CREATION New product is created
Identified by type field in the body, a number rather than the event name
Resource product
{
"type": 16,
"tts_notification_id": "7327112393057371910",
"shop_id": "7494049642642441621",
"timestamp": 1644412885,
"data": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
type | integer | 16 |
timestamp | integer | 1644412885 |
Full schema: 9 fields.
From TikTok Shop docs
-
Content type
application/json
PRODUCT_CATEGORY_CHANGE
documented from TikTok Shop docs (example)
PRODUCT_CATEGORY_CHANGE Product's category is changed
Identified by type field in the body, a number rather than the event name
Resource product
{
"type": 18,
"shop_id": "7494049642642441621",
"tts_notification_id": "7327112393057371910",
"timestamp": 1644412885,
"data": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
type | integer | 18 |
timestamp | integer | 1644412885 |
Full schema: 9 fields.
From TikTok Shop docs
-
Content type
application/json
PRODUCT_AUDIT_STATUS_CHANGE
documented from TikTok Shop docs (example)
PRODUCT_AUDIT_STATUS_CHANGE Product's audit status changes
Identified by type field in the body, a number rather than the event name
Resource product
{
"type": 37,
"shop_id": "7494049642642441621",
"tts_notification_id": "7327112393057371910",
"timestamp": 1644412885,
"data": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
type | integer | 37 |
timestamp | integer | 1644412885 |
Full schema: 13 fields.
From TikTok Shop docs
-
Content type
application/json
Other TikTok Shop events
SELLER_DEAUTHORIZATION
documented from TikTok Shop docs (example)
SELLER_DEAUTHORIZATION Seller has been deauthorized from your app
Identified by type field in the body, a number rather than the event name
{
"type": 6,
"tts_notification_id": "7327112393057371910",
"shop_id": "7494049642642441621",
"timestamp": 1644412885,
"data": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
type | integer | 6 |
timestamp | integer | 1644412885 |
Full schema: 6 fields.
From TikTok Shop docs
-
Content type
application/json
UPCOMING_AUTHORIZATION_EXPIRATION
documented from TikTok Shop docs (example)
UPCOMING_AUTHORIZATION_EXPIRATION Authorization expires in 30 days; repeats daily until re-authorized
Identified by type field in the body, a number rather than the event name
{
"type": 7,
"tts_notification_id": "7327112393057371910",
"shop_id": "7494049642642441621",
"timestamp": 1644412885,
"data": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
type | integer | 7 |
timestamp | integer | 1644412885 |
Full schema: 7 fields.
From TikTok Shop docs
-
Content type
application/json
Route TikTok Shop events by type.
Event Gateway receives every TikTok Shop delivery and filters and routes it by event type, so each service gets only the events it handles.