Connect TikTok Shop to Rig with your own app
Create a custom app against your own TikTok Shop in Partner Center, authorize it, and give Rig the app key, app secret and authorization code. There is no TikTok app review on this path, so you can be connected the same day. Rig exchanges the code for a long-lived token and refreshes it for you from then on.
Roughly 20 minutes, if your shop is eligible
The app creation itself is quick. What catches people out is the two prerequisites below — a shop that has passed verification, and an assigned Account Manager. Check those first.
Why use your own app
TikTok Shop has two kinds of developer. A seller developer builds a custom app that reads its own shop's data. An app developer or system integrator builds a public app that can request access to other sellers' shops.
A custom app is not listed in the TikTok Shop app store and needs no app review, so it is by far the fastest route. A public app requires TikTok's compliance and legal review, which TikTok documents as taking three or more weeks and always applying to UK and US partners. Rig is working through that review so a future version of this connector is a single click — until then, the app is yours.
Because you own the app, you control what it can reach and you can revoke it at any time from Partner Center.
Before you start
TikTok requires two things of the shop before it will let you register as a seller developer at all:
- The TikTok Shop seller account has passed KYB or KYC verification. Any trading shop will have.
- The seller account has an assigned Account Manager. This is the one that most often blocks people. If you are not sure, ask TikTok before you begin.
Use the shop's own email address
Register on Partner Center with the same email as the TikTok Shop account. TikTok names this as the most common cause of failed seller-developer registrations: sign up with a different address and the system classifies you as an app developer instead, and undoing that needs a support ticket.
By the end you will paste three values into Rig: the app key, the app secret and a one-time authorization code.
Step 1: Register as a seller developer
- Sign in to TikTok Shop Partner Center using your Seller Center account. US local sellers use partner.us.tiktokshop.com instead.
- On the business guide, choose For TikTok Shop Seller as your partner type, then click
Start Business. - Select your target seller market, and choose TikTok Shop Seller as the business category.
- Link the activated TikTok Shop account. If you signed in with your Seller Center account, TikTok verifies this automatically and you can skip ahead.
- Check
My Account. Once you see the TikTok Shop seller tag, registration is done.
Step 2: Create the custom app
- Open
App & Servicefrom the navigation panel and clickCreate app & service. - Choose Custom App. This is the type built for a single seller and never listed in the app store — do not choose the public option.
- Name it something recognisable, such as
Rig data sync, and select TikTok Shop Seller as the service category. - Set the market and seller type to match your shop.
- Turn Enable API on, and set the Redirect URL to:
https://ingest.rig.so/tiktok-shop/oauth/callback - Click
Create. On the app detail page, copy the App key and App secret. Treat the secret like a password.
What the redirect URL does
It is where TikTok sends your browser after you approve the app, carrying a one-time authorization code. Rig's page simply displays that code for you to copy — it stores nothing. The code is also visible in your browser's address bar, so you can read it from there if you prefer. TikTok lets you edit this URL after the app is created.
You can leave the Webhook URL blank. Rig pulls on a schedule rather than receiving pushes.
Step 3: Publish the app
Click Publish on the app's page. A custom app publishes automatically — there is no queue and no reviewer. Nothing is listed publicly; publishing just makes the app usable against your own shop.
Step 5: Connect it in Rig
- In Rig, open
Connectionsin the left sidebar and go toSources. - Search for TikTok Shop and open its card.
- Under Whose TikTok Shop app?, leave Our own app selected. The Rig-hosted option is greyed out until TikTok's partner review completes.
- Paste the App key and App secret from step 2.
- Paste the Authorization code from step 4.
- Leave Refresh token blank. It is there only for people who ran the token exchange themselves.
- Click
Connect, then pick which data you want Rig to sync.
Rig exchanges the code for a long-lived token as soon as you connect, and discards the code. From then on Rig refreshes access on its own — there is nothing for you to rotate.
What Rig pulls in
TikTok Shop lands in its own tiktok_shop schema in your warehouse, and stays current with incremental syncs.
- Orders and their line items
- Products and their SKUs
- Finance: daily settlement statements, SKU-level statement transactions, payments, and estimates for transactions that have not settled yet
- Shops covered by the authorization
Troubleshooting
- Rig says the authorization code was rejected: it has expired or already been used. Open the authorization link again and paste the fresh code straight away.
- You cannot register as a seller developer: check the two prerequisites. The shop must have passed KYB or KYC, and it must have an assigned Account Manager.
- Partner Center treats you as an app developer: you signed up with an email that is not the shop's. Contact TikTok or your Account Manager to have the account allowlisted.
- You are asked to complete a data security and privacy review: you are creating a public or partner app rather than a custom one. A custom app needs no review — go back and choose Custom App.
- The redirect page does not load: the code is still in your browser's address bar after
code=. Copy it from there. - Your token stops working later: the authorization has a duration set when you granted it, and it can be revoked from Partner Center. Re-open the authorization link and paste a new code into the existing connection in Rig — you do not need to recreate the app.