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

After verifying your email, you'll see the Connect TikTok Shop page
Select your market from the dropdown. New connections are available for the United States, United Kingdom, Germany, Spain, France, Italy, Mexico, Brazil, Ireland, and Japan. The selected market must match the shop you authorize on TikTok.
Click Connect TikTok Shop
You'll be redirected to TikTok's authorization page
Log in to your TikTok seller account (if not already logged in)
Review the permissions and click Authorize
You'll be redirected back to Dashboardly with a green checkmark confirming the connection

For an existing shop, use Reconnect next to that shop in Settings → Shops. Dashboardly uses the shop's existing authorization path; do not select a different market to work around a connection error.

Continue on a Desktop

Finish this step on a desktop

Your signup is saved. On a desktop, open the address below, enter the same account details, and continue your previous registration. After you confirm your password, we'll return you to this step.

Open app.dashboardly.io/sign-up/create-account on your desktop and use the same email address so Dashboardly can find the registration you already started.

Connecting a client shop?

You can skip this step now and connect client shops from a desktop after setup.

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

Go to Settings → Shops
Click Add Shop
Select your market/region
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.

TikTok may return every shop authorized for your seller account. Dashboardly keeps the market you selected as a strict boundary and never connects a shop from another market during that authorization.

During initial or agency onboarding, Dashboardly can connect all authorized shops in the selected market. From Settings → Shops, Dashboardly adds one eligible, not-yet-connected shop from the selected market per attempt so it can check your plan's shop limit before each addition. Repeat the Settings flow to add another same-market shop. TikTok's Install Now flow also starts with one shop; add any remaining shops from Settings after sign-up. You can switch between connected 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:

Go to Settings → Shops
Find the shop you want to disconnect
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. If Dashboardly cannot refresh a token, new data synchronization pauses only for the affected shop. Your existing dashboards, orders, and historical data remain available.

Dashboardly shows a Data sync paused warning that names the affected shop. The expired-session message also lets you select View Historical Data so you can continue working without reconnecting immediately.

Only the Dashboardly account owner can reconnect a shop. The owner can select Reconnect in the warning or go to Settings → Shops and select Reconnect for the affected shop. Review the confirmation, continue to TikTok Seller Center, and sign in with the exact Seller Center account that owns that shop.

Dashboardly keeps the expired warning visible until TikTok authorization finishes successfully. If the connection cannot start or TikTok does not return the expected shop, Dashboardly leaves your historical data available and shows a recovery message. Retry from Settings → Shops or contact hello@dashboardly.io.

Each shop has its own TikTok authorization. If you have multiple shops, reconnecting one shop does not renew the others. The warning names the affected shop so you can choose the correct TikTok Seller Center account. If TikTok opens a different seller account, sign out or switch accounts before trying again.

Troubleshooting

"Shop Already Connected"

This means another Dashboardly account already has this shop linked. Dashboardly does not move the shop or change its existing data and order history when a second account tries to connect it.

Sign in to the existing Dashboardly account if you recognize it.
If another person on your team owns that account, ask them to add your email as a collaborator.
If you do not recognize the account or need the primary email changed, contact hello@dashboardly.io so support can verify ownership and restore access.

Do not create another Dashboardly account or repeatedly authorize the same shop.

"No Authorized Shops Found"

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

TikTok Authorized Multiple Shops

This is expected for seller accounts that manage several shops. Dashboardly keeps only shops from the market you selected. Initial and agency onboarding can connect those selected-market shops together; Settings and Install Now add one eligible shop at a time. Repeat the Settings flow if another same-market shop remains.

"Authorized Shop Is in a Different Market"

The shop TikTok returned does not match the market selected in Dashboardly. Start again, select the shop's actual market, and authorize that shop.

Partner Center Install Link Does Not Identify a Market

Start the connection from Settings → Shops instead of an old authorization link, select the shop market, and authorize again. New connections are available only in the markets listed above.

"Authorization Failed"

Clear your browser cookies and try again
Make sure you're using the correct TikTok seller account
Confirm that the selected market matches the shop and is currently supported
Check your internet connection