Connect your TikTok Shop

Foregrade connects to your TikTok Shop via official OAuth — the same way TikTok itself authorizes apps. You never share your password with us.

How to connect

1. Go to Settings → Connection in your Foregrade dashboard
2. Click Connect TikTok Shop
3. You'll be redirected to TikTok's authorization page
4. Log in with your TikTok Shop seller account and click Authorize
5. TikTok redirects you back to Foregrade, and your first sync starts automatically

What permissions does Foregrade request?

We request the minimum read-only scopes needed:

• Read orders and order details
• Read returns and refund data
• Read products and pricing
• Read affiliate creator data (for commission tracking)

We do not request permission to modify your shop, products, or inventory.

How long does the first sync take?

• Under 500 orders: less than 2 minutes
• 500 – 5,000 orders: 2 – 5 minutes
• Over 5,000 orders: 5 – 15 minutes

We sync the last 90 days of orders on first connection. After that, new orders appear within 10 minutes via our auto-sync job plus real-time webhooks.

Having trouble connecting?

• Make sure you're logged into the correct TikTok Shop account before clicking Connect
• TikTok Shop's authorization flow only accepts the shop owner — co-admins can't grant third-party app access. This is a TikTok platform requirement, not a Foregrade restriction
• If you see "Invalid region", Foregrade is currently UK-only
• If the redirect fails, clear your browser cookies for tiktok.com and try again

Still stuck? Contact support and include your TikTok Shop ID (not your password) — we'll investigate.