TikTok Shop

OAuth connect

Connect from Destinations or /api/integrations/tiktok/connect. Tokens persist encrypted (destination / integration tables). Complete Seller Center authorization for the shop you intend to list on — a personal TikTok login is not enough.

Hobby counts TikTok Shop as one of your two channels.

Product sync

Publish from the Publisher hub. The worker builds a TikTok Shop product payload from canonical title, images, variants, and price, then writes channel_listings and channel_sync_logs.

You can also target a product via POST /api/products/:id/sync/tiktok when automating. Category and warehouse fields TikTok requires must exist in metadata or the mapper fails loudly.

Inventory

After a TikTok sale, webhooks (or poll) decrement canonical stock through Redis locks and push remaining quantity to other connected channels. Duplicate events are ignored via idempotency keys.

Common errors

• OAuth cancelled — no destination row; start connect again
• Category required — set it on the canonical product metadata
• Image rejected — TikTok needs reachable HTTPS images
• Rate limit — TikTok bulkhead backs off; Shopify/Amazon keep going