Skip to content
⌘K
InboxAsk a human

Integrations: connecting TikTok to Unbox

Updated by Nick

Integrations is where you connect Unbox to TikTok and check that those connections are still healthy. You'll find it under Settings, then Integrations. Connections are per merchant, so each merchant connects its own shop.

TikTok Shop access

The main connection. It syncs your products, video performance and creator messages so they can be reported on and managed in Unbox. Most of what you see in Unbox depends on it and this is set up at onboarding before you access Unbox.

During your onboarding flow, you will get a region-specific authorisation link. The owner of the TikTok Shop account will have to authorise Unbox as the first step.

Advertising data

A separate connection covering ad performance data, and managing which videos are eligible for ads. Unbox works without it, but ads reporting stays empty and actions involving GMV Max will not be performed until it is connected.

  • Authorising opens a short explainer of what to grant, then hands you to TikTok's permission screen.

  • Grant everything we ask for. If any permission is missing we send you back to TikTok until the full set is there, because the ads features cannot run on a partial grant.

  • You then confirm which advertiser account to connect. The closest match to your merchant is already selected.

  • Once it is done the row shows Connected, with the account name, ID and region, plus live campaign figures so you can see data pulling through.

  • Select Connected at any time to see the permissions you granted in TikTok. If any are later removed, the row drops to a warning and the ads features stop working until you authorise again.

Lark Notifications

A webhook connection that posts alerts into a Lark group chat. Unbox works without it, but you won’t get chat alerts for Demonetisation Tickets or Takedown Requests until it’s connected.

  • Open the Lark group you want alerts sent to. Select the menu in the top right, then choose Settings.

  • Under Bots, select Add Bot, then choose Custom Bot. Give it a name, description and colour, then select Add.

  • Turn on Set signature verification.

  • Send us the Webhook URL and the Signature.

  • A message should then appear in the group confirming the bot is configured.

  • After that, a message card is posted to the chat every time a Demonetisation Ticket or Takedown Request action is logged.

Reconnecting

If a connection has lapsed, a banner at the top of the page asks you to reconnect. Until you do, some features will not update or will not behave as expected. Reconnecting works the same way as connecting for the first time, and nothing already in Unbox is lost.

If your data looks out of date

Check this page first. A lapsed connection is the most common reason for products, video performance or messages not refreshing. If both rows show as connected and the data is still stale, contact support.