Connecting Your TikTok Shop

Overview

Connecting your TikTok Shop is the first step to unlocking analytics in Dashboardly. The connection uses TikTok's official OAuth authorization to securely access your shop data.

What Permissions Are Requested?

Dashboardly requests access to the following data through TikTok's secure OAuth:

• Products — Product catalog, inventory levels, and pricing
• Orders — Order history, details, and status
• Finance — Settlement statements and transaction data
• Returns & Refunds — Return and refund records
• Warehouses — Warehouse and fulfillment data

Dashboardly uses this access primarily to read and analyze your shop data. Your TikTok Shop remains fully under your control.

How to Connect

During Sign-Up

1. After verifying your email, you'll see the Connect TikTok Shop page
2. Select your region from the dropdown. Dashboardly supports 15 regions including:
   • United States, United Kingdom, Germany, France, Italy, Spain
   • Indonesia, Thailand, Vietnam, Philippines, Singapore, Malaysia
   • Saudi Arabia, UAE, Brazil
3. Click Connect TikTok Shop
4. You'll be redirected to TikTok's authorization page
5. Log in to your TikTok seller account (if not already logged in)
6. Review the permissions and click Authorize
7. You'll be redirected back to Dashboardly with a green checkmark confirming the connection

From Settings (After Sign-Up)

If you skipped connecting during sign-up, or want to add another shop:

1. Go to Settings → Shops
2. Click Add New Shop
3. Select your market/region
4. Follow the same OAuth authorization flow

Connecting Multiple Shops

Dashboardly supports multiple TikTok Shops depending on your plan. Check dashboardly.io/pricing for current shop limits per plan.

When you authorize with TikTok, Dashboardly automatically discovers all shops linked to your seller account. You can switch between shops using the shop selector in the top navigation bar.

What Happens After Connecting?

Once connected, Dashboardly immediately begins importing your data. This includes:

• Products and SKUs
• Order history
• Financial statements
• Refunds and returns

See How Data Import Works for details on timing and what to expect.

Disconnecting a Shop

To disconnect a shop:

1. Go to Settings → Shops
2. Find the shop you want to disconnect
3. Click Disconnect

Disconnecting revokes Dashboardly's access on TikTok's side. Your historical data in Dashboardly is preserved, but new data will stop syncing.

Reconnecting When Your Token Expires

TikTok authorization tokens expire periodically. When this happens:

• A modal will appear: "Session Expired"
• You can click Reconnect TikTok Shop to re-authorize
• Or click View Historical Data to continue viewing your existing data

The reconnection process is the same as the initial connection — just click through the OAuth flow again.

Troubleshooting

"Shop Already Connected"

This means another Dashboardly account already has this shop linked. Disconnect it from the other account first, or contact support.

"No Authorized Shops Found"

Make sure you're logging in with the TikTok account that owns the shop, not a collaborator account.

"Authorization Failed"

• Clear your browser cookies and try again
• Make sure you're using the correct TikTok seller account
• Check your internet connection