This guide shows you how to connect TikTok Shop to HexaSync to get data from TikTok Shop. The data is used to assess the quality of your product and inventory data and to check the data before you connect to another system.
Before you start
- A Beehexa account. If you do not have one yet, sign up on the same page.
- A TikTok Shop Seller Center seller account that can grant access for the shop you want to connect.
- The list of shops you want to connect. One TikTok Shop authorization can include several shops, but each HexaSync Connector syncs only one shop.
Note: Only when your business requires its own Partner App do you also need to prepare the Service ID, App Key and App Secret from TikTok Shop Partner Center.
Part 1: Authorize the TikTok Shop connection on HexaSync
Step 1: Sign in to HexaSync
- Go to HexaSync and sign in with your Beehexa account.
Step 2: Start the TikTok Shop connection
- Open the TikTok Shop authentication page on HexaSync.
- On the Check connection details screen, find TikTok Shop and select Connect.
Step 3: Confirm the HexaSync app
- HexaSync shows the Select an app for TikTok Shop screen. Select the existing [HexaSync] TikTok Shop Connector App.
- Select Continue.
Note: HexaSync provides the app details and handles the authorization with TikTok Shop for you.
Step 4: Authorize the app in TikTok Shop
Do these steps in order on TikTok Shop:
- At the Authorize step, select your account type.
- At the Cài đặt (Settings) step, set the partner access duration to Không giới hạn (Unlimited), enter your email and select Xác nhận cài đặt (Confirm settings).
- At the Ủy quyền (Authorize) step, select Xác nhận (Confirm), then select Ủy quyền.
- TikTok Shop shows the Connected status.
Note: The TikTok Shop authorization code can be used only once and expires after a few minutes. Complete the authorization step as soon as you start it. Do not leave the page waiting for a long time or reload the page that returns to HexaSync.
Step 5: Finish the HexaSync Connector
- After the TikTok Shop authorization succeeds, the setup continues to the step that creates the Connector on HexaSync.
- HexaSync names the connector automatically in the form [Seller account] TikTok Shop Connector. You do not need to enter anything else. Just select Create Connector to create the connection.
- Keep the page open for a few minutes. HexaSync creates the connector and then moves to the Tasks section of the TikTok Shop Connector App when it finishes.
- You can find and open the Connector in Connector Apps on HexaSync to check the Connector you just created.
After the Connector is created, HexaSync gets data from the connected TikTok Shop store within 30 minutes.
Part 2: Re-authorize the TikTok Shop connection on HexaSync
If you already have a Connector and need to re-authorize the TikTok Shop connection on HexaSync, do the following steps in order.
Step 1: Open the Connector Settings in Connector Apps
- Open Connector Apps and select the TikTok Shop Connector for your store. Select Settings in the left menu.
Step 2: Select Re-authorize
- In Settings, find the TikTok Shop connection details and select Re-authorize.
Cannot run Re-authorize? Only the owner (the person who created it) of the TikTok Shop Connector App can re-authorize the connection. Contact the owner of the Connector App.
Step 3: Confirm the HexaSync TikTok Shop app
- HexaSync shows the Select an app for TikTok Shop screen. Select the existing [HexaSync] TikTok Shop Connector App.
- Select Continue.
Step 4: Authorize the app in TikTok Shop again
- At the Authorize step, select your account type.
- At the Cài đặt step, set the partner access duration to Không giới hạn, enter your email and select Xác nhận cài đặt.
- At the Ủy quyền step, select Xác nhận, then select Ủy quyền.
Part 3: Check that the connection works
The connection works when HexaSync takes you back to the Connector App or the Connector installation page with no error message. If you connect when you do not have a Connector App yet, HexaSync shows the Connection successful screen. Confirm it in two places in HexaSync.
The connection details appear
- Open the Connector App and go to Settings. The TikTok Shop Connection row now shows connection details with a name like
[TikTok Shop] - ABC123 Credential, in place of the Authorize button.
Run a data pull task as a test
Run one data pull task (Puller) of this Connection manually. This is the part that actually calls TikTok Shop, so it is the most accurate test: the task must finish without an authorization error.
- Select Tasks in the left sidebar, then select a TikTok Shop data pull task in the list, for example the product or inventory task.
- Open the Other Actions list and select Pull to run a manual data pull right in the task.
- Wait for the run to finish, then open the result. The result must have no authorization error and must contain records from your store.
Note: If the task reports an authorization error or an access permission error, the connection details are not working yet. Re-authorize by following Part 2: Re-authorize the TikTok Shop connection on HexaSync before you turn on the schedules.
Part 4: Common errors and how to fix them
Each message below is written with the exact English title you see on HexaSync. Most error screens have a Status line and a Detail from gateway or Technical details line. Take a screenshot of these lines when you contact support.
| Message | How to fix it |
|---|---|
| We Could Not Find Your Installation Details | HexaSync cannot find the installation session details, or TikTok Shop did not return an authorization code. This usually happens because you opened the return link in another browser or private window, the browser data was cleared partway through, you declined on TikTok Shop, or the Redirect URL in Partner Center does not match. Select Back to installation and reconnect from the start in the same browser and the same tab, then agree on the TikTok Shop page. |
| We Couldn’t Finish Connecting Your TikTok Shop Account | HexaSync could not exchange the authorization code for an access token. If Technical details shows the code CREDENTIAL_INFORMATION_INVALID, the usual cause is that the authorization code expired or was already used, the App Secret was just changed in Partner Center, or you agreed to authorize but did not select any shop. Select Back to installation and reconnect, complete the consent step right away and do not reload the return page. If you changed the App Secret, enter the new App Secret. If the error repeats with a different code, send the Technical details to support. |
| HexaSync Could Not Verify The Stored Credential | The connection details were saved, but HexaSync could not get a valid access token when it checked again. Select Back to installation and reconnect. If the error remains, send the Status and Detail from gateway lines to support. |
| No Shop Was Authorized | TikTok Shop did not return any authorized shop, so HexaSync cannot call the TikTok Shop API on your behalf. This error appears when you install from a template. Select Back to installation and reconnect, select at least one shop before you agree, and check that the signed-in account can manage that shop. |
| An Error Occurred | An unknown error happened when HexaSync checked the connection details of the Connector. Try again after a few minutes. If the error remains, send the message text to support. |
For other cases, send a screenshot (with sensitive information hidden) to support@beehexa.com.
Part 5: Frequently asked questions
Can one authorization connect several shops?
Yes. One authorization can include several shops of the same seller account. However, each HexaSync Connector syncs only one shop. If you authorize several shops, HexaSync asks you to choose the shop for this Connector. If there is only one shop, HexaSync selects it automatically.
How do I sync one more shop?
Install one more Connector and choose the other shop at the shop selection step. If you authorize the same seller account again, HexaSync updates the existing connection details instead of creating a duplicate.
Do I have to reconnect when the token expires?
No. HexaSync refreshes the access token automatically with the refresh token. You need to reconnect only when you revoke the app’s access on TikTok Shop, change the App Secret of your own app, or want to change the list of authorized shops.
Why do I have to complete the authorization quickly?
The authorization code that TikTok Shop sends back can be used only once and expires after a few minutes. If you leave the page waiting for a long time or reload the return page, the code no longer works and you have to reconnect.
What if I cancel partway through by mistake?
That is fine. HexaSync takes you back to the template installation page, the Connector page, or the connection management page, depending on where you started. You can reconnect at any time.
Does HexaSync write or change data on TikTok Shop?
No. The TikTok Shop Connector App only reads data. It does not write or change data on TikTok Shop.