# TikTok Shop webhook events

Every event here can also reach agents as an MCP event through Hookdeck: [MCP events](https://hookdeck.com/webhooks/tiktok-shop/mcp-events).

Agent skill: `npx skills add hookdeck/webhook-skills --skill tiktok-shop-webhooks` ([details](https://hookdeck.com/webhooks/tiktok-shop/skill))

> Independent reference generated from hookdeck/webhook-registry (commit a24c8d9, 19 Nov 2026). [TikTok Shop's official docs](https://partner.tiktokshop.com/docv2/page/tts-webhooks-overview).

[Overview](https://hookdeck.com/webhooks/tiktok-shop) · [Webhook events (17)](https://hookdeck.com/webhooks/tiktok-shop/events) · [MCP events](https://hookdeck.com/webhooks/tiktok-shop/mcp-events) · [Verify signatures](https://hookdeck.com/webhooks/tiktok-shop/verify) · [Production guide](https://hookdeck.com/webhooks/tiktok-shop/guide-duplicates-ordering-retries-timeouts) · [Agent skill](https://hookdeck.com/webhooks/tiktok-shop/skill)

## fulfillment

### RECIPIENT_ADDRESS_UPDATE

Confidence: documented · Schema: 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 · Object: `fulfillment`

```json
{
  "type": 3,
  "shop_id": "7494049642642441621",
  "timestamp": 1644412885,
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/tiktok-shop/events/recipient-address-update.json)

| Key field | Type | Example |
|---|---|---|
| `type` | integer | `3` |
| `timestamp` | integer | `1644412885` |

From TikTok Shop docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/tiktok-shop/events/recipient-address-update.json)

### PACKAGE_UPDATE

Confidence: documented · Schema: 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 · Object: `fulfillment`

```json
{
  "type": 4,
  "tts_notification_id": "7327112393057371910",
  "shop_id": "7494049642642441621",
  "timestamp": 1644412885,
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/tiktok-shop/events/package-update.json)

| Key field | Type | Example |
|---|---|---|
| `type` | integer | `4` |
| `timestamp` | integer | `1644412885` |

From TikTok Shop docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/tiktok-shop/events/package-update.json)

### INVOICE_STATUS_CHANGE

Confidence: documented · Schema: 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 · Object: `fulfillment`

```json
{
  "type": 36,
  "tts_notification_id": "7327112393057371910",
  "shop_id": "7494049642642441621",
  "timestamp": 1644412885,
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/tiktok-shop/events/invoice-status-change.json)

| Key field | Type | Example |
|---|---|---|
| `type` | integer | `36` |
| `timestamp` | integer | `1644412885` |

From TikTok Shop docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/tiktok-shop/events/invoice-status-change.json)

## messages

### NEW_CONVERSATION

Confidence: documented · Schema: 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 · Object: `messages`

```json
{
  "type": 13,
  "tts_notification_id": "7327112393057371910",
  "shop_id": "7494049642642441621",
  "timestamp": 1644412885,
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/tiktok-shop/events/new-conversation.json)

| Key field | Type | Example |
|---|---|---|
| `type` | integer | `13` |
| `timestamp` | integer | `1644412885` |

From TikTok Shop docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/tiktok-shop/events/new-conversation.json)

### NEW_MESSAGE

Confidence: documented · Schema: 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 · Object: `messages`

```json
{
  "type": 14,
  "tts_notification_id": "7327112393057371910",
  "shop_id": "7494049642642441621",
  "timestamp": 1644412885,
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/tiktok-shop/events/new-message.json)

| Key field | Type | Example |
|---|---|---|
| `type` | integer | `14` |
| `timestamp` | integer | `1644412885` |

From TikTok Shop docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/tiktok-shop/events/new-message.json)

### NEW_MESSAGE_LISTENER

Confidence: documented · Schema: 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 · Object: `messages`

```json
{
  "type": 33,
  "shop_id": "7494049642642441621",
  "tts_notification_id": "7327112393057371910",
  "timestamp": 1644412885,
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/tiktok-shop/events/new-message-listener.json)

| Key field | Type | Example |
|---|---|---|
| `type` | integer | `33` |
| `timestamp` | integer | `1644412885` |

From TikTok Shop docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/tiktok-shop/events/new-message-listener.json)

## order

### ORDER_STATUS_CHANGE

Confidence: documented · Schema: 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 · Object: `order`

```json
{
  "type": 1,
  "tts_notification_id": "7380066284010030890",
  "shop_id": "7495540735365777507",
  "timestamp": 1718305585,
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/tiktok-shop/events/order-status-change.json)

| Key field | Type | Example |
|---|---|---|
| `type` | integer | `1` |
| `timestamp` | integer | `1718305585` |

[View as JSON](https://hookdeck.com/webhooks/tiktok-shop/events/order-status-change.json)

### CANCELLATION_STATUS_CHANGE

Confidence: documented · Schema: 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 · Object: `order`

```json
{
  "type": 11,
  "tts_notification_id": "7327112393057371910",
  "shop_id": "7494049642642441621",
  "timestamp": 1644412885,
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/tiktok-shop/events/cancellation-status-change.json)

| Key field | Type | Example |
|---|---|---|
| `type` | integer | `11` |
| `timestamp` | integer | `1644412885` |

From TikTok Shop docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/tiktok-shop/events/cancellation-status-change.json)

### RETURN_STATUS_CHANGE

Confidence: documented · Schema: 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 · Object: `order`

```json
{
  "type": 12,
  "tts_notification_id": "7327112393057371910",
  "shop_id": "7494049642642441621",
  "timestamp": 1644412885,
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/tiktok-shop/events/return-status-change.json)

| Key field | Type | Example |
|---|---|---|
| `type` | integer | `12` |
| `timestamp` | integer | `1644412885` |

From TikTok Shop docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/tiktok-shop/events/return-status-change.json)

### REVERSE_STATUS_UPDATE

Confidence: documented · Schema: 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 · Object: `order`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/tiktok-shop/events/reverse-status-update.json)

## product

### PRODUCT_STATUS_CHANGE

Confidence: documented · Schema: 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 · Object: `product`

```json
{
  "type": 5,
  "tts_notification_id": "7327112393057371910",
  "shop_id": "7494049642642441621",
  "timestamp": 1644412885,
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/tiktok-shop/events/product-status-change.json)

| Key field | Type | Example |
|---|---|---|
| `type` | integer | `5` |
| `timestamp` | integer | `1644412885` |

From TikTok Shop docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/tiktok-shop/events/product-status-change.json)

### PRODUCT_INFORMATION_CHANGE

Confidence: documented · Schema: 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 · Object: `product`

```json
{
  "type": 15,
  "tts_notification_id": "7327112393057371910",
  "shop_id": "7494049642642441621",
  "timestamp": 1644412885,
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/tiktok-shop/events/product-information-change.json)

| Key field | Type | Example |
|---|---|---|
| `type` | integer | `15` |
| `timestamp` | integer | `1644412885` |

From TikTok Shop docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/tiktok-shop/events/product-information-change.json)

### PRODUCT_CREATION

Confidence: documented · Schema: from TikTok Shop docs (example)

New product is created

Identified by: type field in the body, a number rather than the event name · Object: `product`

```json
{
  "type": 16,
  "tts_notification_id": "7327112393057371910",
  "shop_id": "7494049642642441621",
  "timestamp": 1644412885,
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/tiktok-shop/events/product-creation.json)

| Key field | Type | Example |
|---|---|---|
| `type` | integer | `16` |
| `timestamp` | integer | `1644412885` |

From TikTok Shop docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/tiktok-shop/events/product-creation.json)

### PRODUCT_CATEGORY_CHANGE

Confidence: documented · Schema: from TikTok Shop docs (example)

Product's category is changed

Identified by: type field in the body, a number rather than the event name · Object: `product`

```json
{
  "type": 18,
  "shop_id": "7494049642642441621",
  "tts_notification_id": "7327112393057371910",
  "timestamp": 1644412885,
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/tiktok-shop/events/product-category-change.json)

| Key field | Type | Example |
|---|---|---|
| `type` | integer | `18` |
| `timestamp` | integer | `1644412885` |

From TikTok Shop docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/tiktok-shop/events/product-category-change.json)

### PRODUCT_AUDIT_STATUS_CHANGE

Confidence: documented · Schema: from TikTok Shop docs (example)

Product's audit status changes

Identified by: type field in the body, a number rather than the event name · Object: `product`

```json
{
  "type": 37,
  "shop_id": "7494049642642441621",
  "tts_notification_id": "7327112393057371910",
  "timestamp": 1644412885,
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/tiktok-shop/events/product-audit-status-change.json)

| Key field | Type | Example |
|---|---|---|
| `type` | integer | `37` |
| `timestamp` | integer | `1644412885` |

From TikTok Shop docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/tiktok-shop/events/product-audit-status-change.json)

## Other TikTok Shop events

### SELLER_DEAUTHORIZATION

Confidence: documented · Schema: 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 · Object: `seller`

```json
{
  "type": 6,
  "tts_notification_id": "7327112393057371910",
  "shop_id": "7494049642642441621",
  "timestamp": 1644412885,
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/tiktok-shop/events/seller-deauthorization.json)

| Key field | Type | Example |
|---|---|---|
| `type` | integer | `6` |
| `timestamp` | integer | `1644412885` |

From TikTok Shop docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/tiktok-shop/events/seller-deauthorization.json)

### UPCOMING_AUTHORIZATION_EXPIRATION

Confidence: documented · Schema: 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 · Object: `upcoming_authorization`

```json
{
  "type": 7,
  "tts_notification_id": "7327112393057371910",
  "shop_id": "7494049642642441621",
  "timestamp": 1644412885,
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/tiktok-shop/events/upcoming-authorization-expiration.json)

| Key field | Type | Example |
|---|---|---|
| `type` | integer | `7` |
| `timestamp` | integer | `1644412885` |

From TikTok Shop docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/tiktok-shop/events/upcoming-authorization-expiration.json)

---

Not affiliated with TikTok Shop. Facts are compiled from public sources and linked inline. [View as JSON](https://hookdeck.com/webhooks/tiktok-shop.json) · [Report a correction](https://hookdeck.com/contact)
