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's address on an order is updated

Identified by type field in the body, a number rather than the event name Resource fulfillment

tiktok-shop-recipient-address-update.json
{
  "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

Send example to Inspect → View as JSON

PACKAGE_UPDATE

documented from TikTok Shop docs (example)

Package is combined, split or otherwise changed

Identified by type field in the body, a number rather than the event name Resource fulfillment

tiktok-shop-package-update.json
{
  "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

Send example to Inspect → View as JSON

INVOICE_STATUS_CHANGE

documented from TikTok Shop docs (example)

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

tiktok-shop-invoice-status-change.json
{
  "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

Send example to Inspect → View as JSON

messages

NEW_CONVERSATION

documented from TikTok Shop docs (example)

Customer service agent joins or leaves a conversation

Identified by type field in the body, a number rather than the event name Resource messages

tiktok-shop-new-conversation.json
{
  "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

Send example to Inspect → View as JSON

NEW_MESSAGE

documented from TikTok Shop docs (example)

Message is sent in a customer service conversation

Identified by type field in the body, a number rather than the event name Resource messages

tiktok-shop-new-message.json
{
  "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

Send example to Inspect → View as JSON

NEW_MESSAGE_LISTENER

documented from TikTok Shop docs (example)

Creator sends the seller a message

Identified by type field in the body, a number rather than the event name Resource messages

tiktok-shop-new-message-listener.json
{
  "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

Send example to Inspect → View as JSON

order

ORDER_STATUS_CHANGE

documented from TikTok Shop docs (example)

Order is placed or its status changes

Identified by type field in the body, a number rather than the event name Resource order

tiktok-shop-order-status-change.json
{
  "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.

Send example to Inspect → View as JSON

CANCELLATION_STATUS_CHANGE

documented from TikTok Shop docs (example)

Order's cancellation request changes status

Identified by type field in the body, a number rather than the event name Resource order

tiktok-shop-cancellation-status-change.json
{
  "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

Send example to Inspect → View as JSON

RETURN_STATUS_CHANGE

documented from TikTok Shop docs (example)

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

tiktok-shop-return-status-change.json
{
  "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

Send example to Inspect → View as JSON

REVERSE_STATUS_UPDATE

documented No payload yet

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.

Help fill this in → View as JSON

product

PRODUCT_STATUS_CHANGE

documented from TikTok Shop docs (example)

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

tiktok-shop-product-status-change.json
{
  "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

Send example to Inspect → View as JSON

PRODUCT_INFORMATION_CHANGE

documented from TikTok Shop docs (example)

Edits to a live product take effect

Identified by type field in the body, a number rather than the event name Resource product

tiktok-shop-product-information-change.json
{
  "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

Send example to Inspect → View as JSON

PRODUCT_CREATION

documented from TikTok Shop docs (example)

New product is created

Identified by type field in the body, a number rather than the event name Resource product

tiktok-shop-product-creation.json
{
  "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

Send example to Inspect → View as JSON

PRODUCT_CATEGORY_CHANGE

documented from TikTok Shop docs (example)

Product's category is changed

Identified by type field in the body, a number rather than the event name Resource product

tiktok-shop-product-category-change.json
{
  "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

Send example to Inspect → View as JSON

PRODUCT_AUDIT_STATUS_CHANGE

documented from TikTok Shop docs (example)

Product's audit status changes

Identified by type field in the body, a number rather than the event name Resource product

tiktok-shop-product-audit-status-change.json
{
  "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

Send example to Inspect → View as JSON

Other TikTok Shop events

SELLER_DEAUTHORIZATION

documented from TikTok Shop docs (example)

Seller has been deauthorized from your app

Identified by type field in the body, a number rather than the event name

tiktok-shop-seller-deauthorization.json
{
  "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

Send example to Inspect → View as JSON

UPCOMING_AUTHORIZATION_EXPIRATION

documented from TikTok Shop docs (example)

Authorization expires in 30 days; repeats daily until re-authorized

Identified by type field in the body, a number rather than the event name

tiktok-shop-upcoming-authorization-expiration.json
{
  "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

Send example to Inspect → View as 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.

Not affiliated with TikTok Shop. Facts are compiled from public sources and linked inline.