First sync timing and what to expect

After you connect your TikTok Shop, Foregrade pulls the last 90 days of order and return history. Here's what happens and in what order.

Sync stages

1. Authorization (instant) — OAuth tokens stored encrypted
2. Order list pull (10-60 seconds) — fetches order IDs and summary data
3. Order details (1-15 minutes depending on volume) — fetches the fee breakdown for each order
4. Returns sync (10-60 seconds) — fetches return and refund records
5. Affiliate sync (10-60 seconds) — fetches creator commission data

How often does data refresh?

• Webhooks — new orders and returns appear within seconds of TikTok notifying us
• Auto-sync cron — every 10 minutes as a safety net for webhooks that get dropped
• Manual sync — click Sync now in the dashboard to force a refresh (rate-limited to once every 15 minutes on paid plans)

Why is my profit number different from TikTok's?

TikTok's reports show gross revenue minus platform fees. They don't subtract your cost of goods sold (COGS), affiliate commissions paid, or return costs. Foregrade subtracts all of those to show real net profit. See How profit is calculated for the full formula.

The sync seems stuck

If the sync bar sits at "Syncing..." for more than 20 minutes:

1. Hard-refresh the page (Cmd+Shift+R or Ctrl+Shift+R)
2. Check status.foregrade.io for incidents
3. Contact support with your TikTok Shop ID