Using the Marketplace Modal?
When configuring column mappings in the Add/Edit Marketplace dialog, use dynamic variables like
productTitle or variantSku to auto-populate fields from your product catalog.📋Before You Start
- Active TikTok Shop seller account (US or other supported region)
- TikTok Shop account approved for selling
🔧Setup Steps
- 1Start the TikTok Shop OAuth flowIn Pythias, go to Admin → Integrations → Add New Integration → TikTok Shop. Click Connect with TikTok Shop. You will be redirected to TikTok's authorization page.
- 2Authorize Pythias on TikTok ShopSign in with your TikTok Seller Center account. TikTok will show the permissions Pythias is requesting: Orders management, Shipping management, and Products management (optional). Click Confirm authorization.
- 3Select your TikTok ShopIf your TikTok account manages multiple shops, select the shop you want to connect. Click Save.
- 4Configure shipping settingsTikTok Shop has strict fulfillment windows (typically 2 business days). In the Pythias TikTok integration settings, enable urgency flags for orders approaching the fulfillment deadline. Set your default carrier for TikTok orders.
🔄What Gets Synced
- New paid orders (pulled every 5 minutes)
- Order items, product SKUs, quantities, personalization, and shipping address
- Package tracking confirmation pushed to TikTok Shop
- Order status update (Awaiting Shipment → Shipped)
💡Tips & Troubleshooting
- TikTok Shop's Late Shipment Rate (LSR) threshold is 2%. Fulfill all orders within the required window to maintain seller standing.
- TikTok OAuth tokens expire. Pythias will notify you 7 days before expiry so you can re-authorize.
- During TikTok Live events, order volume can spike dramatically. Monitor your Pythias production queue during scheduled lives.
- If you use TikTok's in-house shipping (TikTok Shipping), Pythias can pull the pre-generated label URL for printing.

