{
  "generated_from": "hookdeck/webhook-registry",
  "registry_commit": "a24c8d9784c9e9fe937c63f76adbce108201378f",
  "registry_committed_at": "2026-11-19T08:56:09Z",
  "disclaimer": "Independent reference. Not affiliated with TikTok Shop.",
  "vendor": "tiktok-shop",
  "name": "TikTok Shop",
  "official_docs": "https://partner.tiktokshop.com/docv2/page/tts-webhooks-overview",
  "docs_checked": "2026-10-29",
  "url": "https://hookdeck.com/webhooks/tiktok-shop",
  "pages": [
    {
      "tab": "overview",
      "label": "Overview",
      "url": "https://hookdeck.com/webhooks/tiktok-shop"
    },
    {
      "tab": "events",
      "label": "Webhook events",
      "url": "https://hookdeck.com/webhooks/tiktok-shop/events"
    },
    {
      "tab": "mcp-events",
      "label": "MCP events",
      "url": "https://hookdeck.com/webhooks/tiktok-shop/mcp-events"
    },
    {
      "tab": "verify",
      "label": "Verify signatures",
      "url": "https://hookdeck.com/webhooks/tiktok-shop/verify"
    },
    {
      "tab": "guide",
      "label": "Production guide",
      "url": "https://hookdeck.com/webhooks/tiktok-shop/guide-duplicates-ordering-retries-timeouts"
    },
    {
      "tab": "skill",
      "label": "Agent skill",
      "url": "https://hookdeck.com/webhooks/tiktok-shop/skill"
    }
  ],
  "summary": "TikTok Shop signs every webhook with authorization (HMAC-SHA256, lowercase hex).",
  "facts": [
    {
      "key": "signature_header",
      "label": "Signature header",
      "value": "authorization",
      "detail": "Format: `<lowercase hex>`, with no `Bearer` prefix",
      "source": {
        "kind": "vendor-docs",
        "label": "TikTok Shop docs",
        "href": "https://partner.tiktokshop.com/docv2/page/tts-webhooks-overview"
      },
      "doc_discrepancy": null
    },
    {
      "key": "scheme",
      "label": "Scheme",
      "value": "HMAC-SHA256, lowercase hex",
      "detail": null,
      "source": {
        "kind": "vendor-docs",
        "label": "TikTok Shop docs",
        "href": "https://partner.tiktokshop.com/docv2/page/tts-webhooks-overview"
      },
      "doc_discrepancy": null
    },
    {
      "key": "signed_material",
      "label": "Signed material",
      "value": "{app_key}{raw body}",
      "detail": "Your app key, then the raw request body as sent, with nothing between them.",
      "source": {
        "kind": "vendor-docs",
        "label": "TikTok Shop docs",
        "href": "https://partner.tiktokshop.com/docv2/page/tts-webhooks-overview"
      },
      "doc_discrepancy": null
    },
    {
      "key": "identified_by",
      "label": "How events are identified",
      "value": "type field in the body, a number rather than the event name",
      "detail": null,
      "source": {
        "kind": "vendor-docs",
        "label": "TikTok Shop docs",
        "href": "https://partner.tiktokshop.com/docv2/page/tts-webhooks-overview"
      },
      "doc_discrepancy": null
    },
    {
      "key": "body_format",
      "label": "Body format",
      "value": "JSON",
      "detail": "Content type: application/json.",
      "source": {
        "kind": "vendor-docs",
        "label": "TikTok Shop docs",
        "href": "https://partner.tiktokshop.com/docv2/page/tts-webhooks-overview"
      },
      "doc_discrepancy": null
    },
    {
      "key": "envelope",
      "label": "Envelope",
      "value": "type, tts_notification_id, shop_id, timestamp, data",
      "detail": null,
      "source": {
        "kind": "vendor-docs",
        "label": "TikTok Shop docs",
        "href": "https://partner.tiktokshop.com/docv2/page/tts-webhooks-overview"
      },
      "doc_discrepancy": null
    },
    {
      "key": "agent_skill",
      "label": "Agent skill",
      "value": "npx skills add hookdeck/webhook-skills --skill tiktok-shop-webhooks",
      "detail": null,
      "source": {
        "kind": "webhook-skills",
        "label": "Agent skill →",
        "href": "https://hookdeck.com/webhooks/tiktok-shop/skill"
      },
      "doc_discrepancy": null
    }
  ],
  "not_yet_known": [],
  "enumeration": {
    "status": "partial",
    "source_url": "https://partner.tiktokshop.com/docv2/page/tts-webhooks-overview",
    "checked": "2026-07-29"
  },
  "counts": {
    "events": 17,
    "with_payload": 16,
    "captured": 0,
    "with_description": 17,
    "resources": 5,
    "confidence": {
      "verified": 0,
      "documented": 17,
      "inferred": 0
    }
  },
  "mcp": {
    "native": "unknown",
    "checked": null,
    "via_hookdeck": "any TikTok Shop event"
  },
  "events": [
    {
      "name": "ORDER_STATUS_CHANGE",
      "resource": "order",
      "description": "Order is placed or its status changes",
      "confidence": "documented",
      "schema_source": "from TikTok Shop docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/tiktok-shop/events#ORDER_STATUS_CHANGE",
      "json": "https://hookdeck.com/webhooks/tiktok-shop/events/order-status-change.json"
    },
    {
      "name": "RECIPIENT_ADDRESS_UPDATE",
      "resource": "fulfillment",
      "description": "Recipient's address on an order is updated",
      "confidence": "documented",
      "schema_source": "from TikTok Shop docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/tiktok-shop/events#RECIPIENT_ADDRESS_UPDATE",
      "json": "https://hookdeck.com/webhooks/tiktok-shop/events/recipient-address-update.json"
    },
    {
      "name": "PACKAGE_UPDATE",
      "resource": "fulfillment",
      "description": "Package is combined, split or otherwise changed",
      "confidence": "documented",
      "schema_source": "from TikTok Shop docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/tiktok-shop/events#PACKAGE_UPDATE",
      "json": "https://hookdeck.com/webhooks/tiktok-shop/events/package-update.json"
    },
    {
      "name": "PRODUCT_STATUS_CHANGE",
      "resource": "product",
      "description": "Product passes or fails audit, or the platform changes its status",
      "confidence": "documented",
      "schema_source": "from TikTok Shop docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/tiktok-shop/events#PRODUCT_STATUS_CHANGE",
      "json": "https://hookdeck.com/webhooks/tiktok-shop/events/product-status-change.json"
    },
    {
      "name": "SELLER_DEAUTHORIZATION",
      "resource": "seller",
      "description": "Seller has been deauthorized from your app",
      "confidence": "documented",
      "schema_source": "from TikTok Shop docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/tiktok-shop/events#SELLER_DEAUTHORIZATION",
      "json": "https://hookdeck.com/webhooks/tiktok-shop/events/seller-deauthorization.json"
    },
    {
      "name": "UPCOMING_AUTHORIZATION_EXPIRATION",
      "resource": "upcoming_authorization",
      "description": "Authorization expires in 30 days; repeats daily until re-authorized",
      "confidence": "documented",
      "schema_source": "from TikTok Shop docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/tiktok-shop/events#UPCOMING_AUTHORIZATION_EXPIRATION",
      "json": "https://hookdeck.com/webhooks/tiktok-shop/events/upcoming-authorization-expiration.json"
    },
    {
      "name": "CANCELLATION_STATUS_CHANGE",
      "resource": "order",
      "description": "Order's cancellation request changes status",
      "confidence": "documented",
      "schema_source": "from TikTok Shop docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/tiktok-shop/events#CANCELLATION_STATUS_CHANGE",
      "json": "https://hookdeck.com/webhooks/tiktok-shop/events/cancellation-status-change.json"
    },
    {
      "name": "RETURN_STATUS_CHANGE",
      "resource": "order",
      "description": "Order's return, refund or replacement request changes status",
      "confidence": "documented",
      "schema_source": "from TikTok Shop docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/tiktok-shop/events#RETURN_STATUS_CHANGE",
      "json": "https://hookdeck.com/webhooks/tiktok-shop/events/return-status-change.json"
    },
    {
      "name": "NEW_CONVERSATION",
      "resource": "messages",
      "description": "Customer service agent joins or leaves a conversation",
      "confidence": "documented",
      "schema_source": "from TikTok Shop docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/tiktok-shop/events#NEW_CONVERSATION",
      "json": "https://hookdeck.com/webhooks/tiktok-shop/events/new-conversation.json"
    },
    {
      "name": "NEW_MESSAGE",
      "resource": "messages",
      "description": "Message is sent in a customer service conversation",
      "confidence": "documented",
      "schema_source": "from TikTok Shop docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/tiktok-shop/events#NEW_MESSAGE",
      "json": "https://hookdeck.com/webhooks/tiktok-shop/events/new-message.json"
    },
    {
      "name": "PRODUCT_INFORMATION_CHANGE",
      "resource": "product",
      "description": "Edits to a live product take effect",
      "confidence": "documented",
      "schema_source": "from TikTok Shop docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/tiktok-shop/events#PRODUCT_INFORMATION_CHANGE",
      "json": "https://hookdeck.com/webhooks/tiktok-shop/events/product-information-change.json"
    },
    {
      "name": "PRODUCT_CREATION",
      "resource": "product",
      "description": "New product is created",
      "confidence": "documented",
      "schema_source": "from TikTok Shop docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/tiktok-shop/events#PRODUCT_CREATION",
      "json": "https://hookdeck.com/webhooks/tiktok-shop/events/product-creation.json"
    },
    {
      "name": "PRODUCT_CATEGORY_CHANGE",
      "resource": "product",
      "description": "Product's category is changed",
      "confidence": "documented",
      "schema_source": "from TikTok Shop docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/tiktok-shop/events#PRODUCT_CATEGORY_CHANGE",
      "json": "https://hookdeck.com/webhooks/tiktok-shop/events/product-category-change.json"
    },
    {
      "name": "NEW_MESSAGE_LISTENER",
      "resource": "messages",
      "description": "Creator sends the seller a message",
      "confidence": "documented",
      "schema_source": "from TikTok Shop docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/tiktok-shop/events#NEW_MESSAGE_LISTENER",
      "json": "https://hookdeck.com/webhooks/tiktok-shop/events/new-message-listener.json"
    },
    {
      "name": "INVOICE_STATUS_CHANGE",
      "resource": "fulfillment",
      "description": "Invoice upload changes status, in the Brazil market only",
      "confidence": "documented",
      "schema_source": "from TikTok Shop docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/tiktok-shop/events#INVOICE_STATUS_CHANGE",
      "json": "https://hookdeck.com/webhooks/tiktok-shop/events/invoice-status-change.json"
    },
    {
      "name": "PRODUCT_AUDIT_STATUS_CHANGE",
      "resource": "product",
      "description": "Product's audit status changes",
      "confidence": "documented",
      "schema_source": "from TikTok Shop docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/tiktok-shop/events#PRODUCT_AUDIT_STATUS_CHANGE",
      "json": "https://hookdeck.com/webhooks/tiktok-shop/events/product-audit-status-change.json"
    },
    {
      "name": "REVERSE_STATUS_UPDATE",
      "resource": "order",
      "description": "Buyer's cancellation, refund or return request needs the seller's decision",
      "confidence": "documented",
      "schema_source": "No payload yet",
      "has_payload": false,
      "url": "https://hookdeck.com/webhooks/tiktok-shop/events#REVERSE_STATUS_UPDATE",
      "json": "https://hookdeck.com/webhooks/tiktok-shop/events/reverse-status-update.json"
    }
  ]
}