Connect TikTok Shop to The Hut Group

This article walks you through connecting TikTok Shop and The Hut Group (THG) so they can share inventory, fulfillment, and returns through the app.

Two things to know before you start:

  • The Hut Group setup is complex. THG is marked Limited availability in the app. Contact your customer success manager or submit a support request before you begin.
  • No product sync between THG and the app. Create products directly in THG and in TikTok Shop. The app matches them by identifier and keeps the rest in sync.

What syncs

Data Direction Notes
Orders THG → App THG sends shipment requests to the app, and they arrive as orders.
Cancellations App → THG Sent to THG.
Returns THG ↔ App Inbound and outbound.
Inventory App → THG Pushed out to THG.
Fulfillments App → THG Pushed out to THG.
Locations THG → App Optional. Created from the THG warehouses you list in the integration settings. Can also be created manually.
Products - Not synced. Maintain in each platform.

On the TikTok Shop side, product, inventory, and fulfillment sync work normally - with one exception: pushing products to TikTok Shop is available only for US and UK regions. Outside those regions, maintain the TikTok Shop catalog in TikTok Shop directly.


Before you begin

Connect TikTok Shop first. See Connect TikTok to Pipe17.

Then gather the following for the THG setup:

  • THG-supplied credentials: THG realm, THG client ID, THG client secret. Request these from your THG integration contact.
  • User name and password: You choose these, enter them in the app, and share them with THG. THG uses them when it sends orders to the app.
  • THG warehouse list: The name and THG warehouse ID of each warehouse you'll use, if you plan to pull locations into the app.
  • Identifier strategy: Decide how to reconcile THG's UPC with the SKU the app uses. See Step 3.

For more background, see Connect The Hut Group (THG) to Pipe17.


Step 1: Connect The Hut Group

  1. Navigate to Integrations and click Add integration. Search for The Hut Group and select it. The Connect The Hut Group pop-up opens.
  2. Enter the THG realm, THG client ID, and THG client secret from your THG integration contact.
  3. In User name and Password, enter the values you chose for THG.
  4. Click Connect.
  5. Submit a support request for this integration's THG webhook URLs. Send them to THG with the user name and password, and ask THG to send shipment requests and returns to them.

The connection isn't fully active until THG completes their step. For the full connection steps, see Connect The Hut Group (THG) to Pipe17.


Step 2: Configure TikTok Shop

If you haven't connected TikTok Shop yet, follow Connect TikTok to Pipe17 first.

  1. Open the TikTok integration. On the Settings tab, set Process product catalog updates to the option that matches how you want to handle the TikTok catalog:
    • Pull products from Tiktok to Pipe17 - bring the TikTok Shop catalog into the app for matching.
    • Push products from Pipe17 to Tiktok - only relevant if you have another catalog source connected. US and UK only.
    • Disabled - when you maintain TikTok and THG catalogs independently and only need inventory, fulfillment, and returns sync.
  2. Click Save.
  3. Confirm both integrations show Connected on Integrations with no errors.

Step 3: Match products by identifier

THG identifies products by UPC. The app identifies products by SKU. You need to align them before anything else will sync correctly.

Pick one of three approaches and apply it across your full catalog:

Option A - Reverse UPC and SKU in THG
Use THG's SKU field to hold the same value as your app's master SKU. This is the simplest path and works well for most setups.

Option B - Map per product in Channel Options
The Hut Group connector supports per-product SKU mapping. On each product's page in the app, scroll to Channel Options. The Hut Group row has a Channel SKU column - enter the THG UPC value there.

Notes:

  • The TikTok row also has a Channel SKU column. If a TikTok Shop seller SKU differs from the app's master SKU, enter it there.
  • The Channel SKU column is hidden on parent products with no channel SKUs set. Open a child or variant product to set values.

Option C - Custom mapping
For large or complex catalogs, work with Pipe17 support to set up custom identifier mapping.

Don't mix approaches across products - it makes mismatches hard to diagnose later.

Optional: limit inventory sync to specific SKUs

If you're rolling out THG inventory gradually, use Process inventory information only for products with specific SKUs on The Hut Group integration. Inventory updates push to THG only for products in the list.


Step 4: Set up locations

You can either pull THG locations into the app or create them manually.

Pull locations from THG

  1. Get the warehouse name and THG warehouse ID of each warehouse from your THG integration contact.
  2. On The Hut Group integration's Settings tab, enter each warehouse in THG locations (warehouses) specified as name:id pairs as Name:WarehouseID.
  3. Turn on Pull locations from THG.
  4. Click Save. The locations appear under Inventory > Locations.

Create locations manually

  1. Go to Inventory > Locations and click Create location.
  2. Enter the location details, including the physical address.
  3. Don't select The Hut Group as the 3PL Integration - THG is a marketplace, not a 3PL.
  4. Repeat for each THG location.

Either way, set each location's 3PL Integration to the 3PL or warehouse integration that ships its orders. If your 3PL integration already created a location for the same warehouse, merge the two. See Using Locations and Merging Locations.


Step 5: Enable sync and test

On The Hut Group integration's Settings tab, turn on the settings you need, and click Save:

  • Accept orders from THG - receive THG shipment requests as orders.
  • Push fulfillments information to THG - send dispatches with tracking to THG.
  • Push inventory information to THG - send stock levels to THG.
  • Accept returns (RMAs) from THG and Push returns (RMAs) updates to THG - receive returns and send return updates back.

THG sends orders to the app, so the app doesn't pull order history from THG. Exclude orders created before this date only filters the orders THG sends. If you need older orders in the app, ask THG to resend them, or contact Pipe17 support.

Test with one order: ask THG to send one test shipment request. It appears in Orders. Ship it, and ask THG to confirm they received the dispatch.

On the TikTok Shop side, set up routing rules in Order Routing > Routing Rules so orders route to the right fulfillment location. See Creating Order Routing Rules. Orders that TikTok ships (including FBT) come in only when Pull shipped by platform orders is on in the TikTok integration. They arrive already fulfilled and don't go through the Order Routing Engine.


Best practices

  • Get onboarding involved early.
  • Pick your identifier strategy before connecting and stick to it.
  • Audit identifiers for uniqueness before going live. Duplicates cause silent mismatches.
  • Pull THG locations into the app if THG can supply stable warehouse IDs.
  • Test with one order before THG starts sending all orders.
  • For non-US/UK TikTok Shops, manage the TikTok catalog directly in TikTok Shop.

Troubleshooting

  • Connection saved but no data flows
    THG hasn't activated their side yet, or Accept orders from THG is off. Confirm you've sent the webhook URLs, user name, and password to THG, and that the setting is on.
  • Connect fails, or the integration stops with "invalid_token" or "invalid_grant"
    Re-check THG realm, THG client ID, and THG client secret against the values from THG. A single typo blocks authentication, and the secret may have changed.
  • THG reports "Not authorized" (403) when it sends orders
    The user name or password THG sends doesn't match the integration. Make sure both match exactly, or set new ones and share them with THG.
  • Orders aren't matching products
    Almost always the UPC-vs-SKU mismatch. Pick one of the three approaches in Step 3 and apply it consistently.
  • The Channel SKU column is hidden on a parent product
    Open a child or variant product to set channel SKUs.
  • Inventory totals on THG look wrong
    Check that the right locations are aggregated. If totals still look off, turn on Force inventory resync on The Hut Group integration to refresh.
  • Inventory is updating for the wrong products
    Check whether Process inventory information only for products with specific SKUs is set. If the list is populated, only those products receive updates.
  • Orders are missing from a date range
    Check Exclude orders created before this date on The Hut Group integration. The app doesn't pull past orders from THG; ask THG to resend missing orders, or contact Pipe17 support.
  • A fulfillment, cancellation, or inventory update fails with "Warehouse can not be resolved"
    Add the warehouse to THG locations (warehouses) specified as name:id pairs with the right ID, and turn on Pull locations from THG.
  • A THG order routed to the wrong location
    If you pulled locations from THG, double-check the name:id pairs. If you created them manually, verify each location. Then review your rules in Order Routing > Routing Rules.
  • A TikTok Shop order routed to the wrong location
    Review your rules in Order Routing > Routing Rules. SKU matching does not control routing.
  • Returns aren't flowing
    Confirm Accept returns (RMAs) from THG (inbound) or Push returns (RMAs) updates to THG (outbound) is on for the direction you need.


Need Help?

If you need additional assistance:

  • Use Ask Pippen, our AI agent, located at the top of the platform page.
  • Submit a support request with as much relevant detail as possible. Learn how to submit a request.

We’re here to help you succeed with your operations.

Was this article helpful?
0 out of 0 found this helpful

Comments

0 comments

Article is closed for comments.

Have more questions?
Submit a request
Share it, if you like it.