The TikTok connector links your TikTok Shop to the app, automating order ingestion, inventory updates, fulfillment posting, product sync, returns, refunds, and statements between TikTok and your downstream systems. It keeps order data, stock levels, and shipment confirmations in sync so your operations team can manage TikTok orders alongside other sales channels without manual intervention.
Key capabilities:
- Pull TikTok Shop orders, returns, refunds, and statements into the app.
- Push inventory updates from the app to TikTok Shop.
- Post fulfillment and tracking information to TikTok after orders ship.
- Sync product catalog data to TikTok, including AI-assisted attribute handling.
- Track FBT (Fulfilled by TikTok) inventory through dedicated locations.
Scope: one integration per region
The TikTok connector operates on a one shop = one integration basis. Each TikTok Shop has its own unique identifiers and maintains an independent integration state in the app. This state tracks order, product, and inventory processing, and is core to how the app ensures data accuracy and avoids duplication.
Because of this architecture, shops cannot be consolidated into a single connector, even if they belong to the same TikTok Seller account or share inventory (for example, EU cross-border via FBT). While TikTok's Seller Center presents multiple regions under one login, the underlying API treats each shop separately. The app mirrors this structure to support current use cases as well as scenarios like Fulfilled by Seller (FBS), where each shop may map to different fulfillment locations.
As a result, onboarding additional TikTok regions requires creating separate integrations per country/shop. Existing configurations such as connector settings, mappings, and rules can be exported from one integration and imported into others, minimizing setup time and ensuring consistency across regions.
Setup
Before you begin:
- An active TikTok Shop Seller account with administrator access for the region you are connecting.
- Permission in the app to create and configure connectors.
- One integration per region - repeat the steps below for each TikTok Shop you plan to connect.
To connect TikTok Shop to the app:
- Navigate to Integrations in the app.
- Click Add Integration and select TikTok.
- Enter a unique connector name that identifies the region or shop (for example,
TikTok USorTikTok UK). - Click Connect to TikTok to launch the TikTok authorization window.
- Sign in to your TikTok Seller account and select the shop region you want to connect.
- Review the requested permissions and click Authorize to grant access.
- Confirm that the connector returns to the app and displays a connected status.
- Configure the connector settings as described in the Settings section below.
- Click Save changes to apply the configuration.
To onboard additional regions, repeat these steps for each TikTok Shop. To reuse an existing configuration, export settings, mappings, and rules from a configured integration and import them into the new one.
Flows
| Flow | Direction | Notes |
|---|---|---|
| Fulfillments | Pipe17 → TikTok | Shipment confirmations and tracking are posted to TikTok after orders ship. Use fallback carrier if fulfilment carrier does not match supported carriers on TTS controls behavior when the carrier is not supported by TTS. Orders pulled with Pull shipped by platform orders are treated as already fulfilled and do not generate fulfillments from Pipe17. |
| Inventory | Pipe17 → TikTok | Inventory pushes to TikTok per Push inventory from a specific location only and Send total inventory to a default warehouse id. Optionally throttled to the 12:00AM–2:00AM PST window via Apply TikTok inventory increase only between 12:00AM PST - 2:00AM PST. Can be limited to specific SKUs or forced to resync. |
| Locations | TikTok → Pipe17 | When Create FBT locations to track TikTok fulfillable inventory quantities is enabled, FBT locations are created in Pipe17 to track TikTok-fulfillable inventory. Optionally consolidated to a single default location via Consolidate FBT Inventory from all locations to a single default Location. |
| Orders | Bidirectional | Orders are pulled from TikTok based on Exclude orders created before this date and Pull orders only with these TikTok statuses, with optional inclusion of On Hold and platform-fulfilled (TTS) orders. Cancellations push from Pipe17 to TikTok when Cancel order in TikTok Shop when order is canceled in Pipe17 is enabled, using the configured default cancel reasons. Optional buyer messages and Order cards are also sent to TikTok on order creation. |
| Products | Bidirectional | Catalog updates push to TikTok per the Products settings (Safe Update for TikTok Product Push, Update only specific product properties, Attributes mapping, AI attribute handling, etc.). Catalog data is also pulled from TikTok for matching and for recovery of deleted products by SKU or Product ID. |
| Refunds | Bidirectional | Refunds are pulled from TikTok per Pull refunds TikTok types and Pull refunds only with this statuses. Refunds and cancellations created in Pipe17 push to TikTok using the configured default refund and cancellation reasons. Reject Buyer Refund Requests for Seller-Initiated Cancellations controls handling when a buyer refund request exists alongside a seller cancellation. |
| Returns | TikTok → Pipe17 | Returns are pulled per Pull returns only with this statuses and can be restricted to returns with a matching order via Pull returns only when there is a matching order available in Pipe17. |
| Statement Transactions | TikTok → Pipe17 | Statement transactions (line-level financial records associated with statements) are ingested from TikTok. |
| Statements | TikTok → Pipe17 | Statements are ingested from TikTok, filtered by Exclude statements created before this date. |
Each flow operates within the scope of a single TikTok Shop. Cross-region operations require separate integrations per shop, even when shops share inventory or fulfillment networks.
Settings
The TikTok connector settings are grouped under Locations, Orders, Fulfillments, Products, Inventory, Returns, Refunds, and Statements.
Locations
| Setting | Description | Options/Default |
|---|---|---|
| Create FBT locations to track TikTok fulfillable inventory quantities | Enable to allow collecting FBT inventory. | On / Off. Default: Off. |
| Consolidate FBT Inventory from all locations to a single default Location | A new default location is created where inventory from all FBT locations is consolidated. Useful to push consolidated FBT inventory to an ERP. | On / Off. Default: Off. |
Orders
| Setting | Description | Options/Default |
|---|---|---|
| Exclude orders created before this date | Cutoff date and time. Orders created before this point are not pulled into Pipe17. If left empty, the default is the integration creation date. | Date/time. Default: integration creation timestamp. |
| Pull orders only with these TikTok statuses | TikTok order statuses whose orders and updates are pulled into Pipe17. | Multi-select. Default: Awaiting shipment, Cancelled, Delivered. |
| Pull shipped by platform orders | When enabled, Pipe17 pulls orders fulfilled by TTS. These orders are pulled in as already Fulfilled - Pipe17 does not create shipments or fulfillment (tracking) for them. | On / Off. Default: Off. |
| Pull Orders in On Hold status | Pulls TikTok On Hold orders into Pipe17 with status onHold. TikTok releases the order after 1 hour, after which Pipe17 updates the status to New. Helps account for inventory already committed on TikTok. | On / Off. Default: Off. |
| Pull only the Orders with specific Order Ids | When set, only orders whose IDs are in this list are ingested during normal polling. Orders are still pulled by modification time, so unchanged orders are not re-pushed each cycle. | Free text list. Default: empty. |
| Cancel order in TikTok Shop when order is canceled in Pipe17 | When enabled, an order canceled in Pipe17 is also canceled in TikTok Shop. | On / Off. Default: Off. |
| Default cancel reason for line items | Default TikTok cancel reason code used when canceling line items in TikTok Shop if no reason is provided from the 3PL. Must be a valid TikTok cancel reason code. | Dropdown. Default: Out of stock (seller_cancel_reason_out_of_stock). |
| Default cancel reason for full order | Default TikTok cancel reason code used when canceling a full order in TikTok Shop if no reason is provided from the 3PL. Must be a valid TikTok cancel reason code. | Dropdown. Default: Out of stock (seller_cancel_reason_out_of_stock). |
| Support virtual bundles | Enables support for virtual bundles on TikTok orders. | On / Off. Default: On. |
| Send a Message to the buyer once an Order is created | When an order is created in Pipe17, the buyer receives a text message based on the template below. | On / Off. Default: Off. |
| Message Template | Template used for the buyer message. Maximum 2,000 characters. Example: "Thank you for purchasing from CompanyName, please contact us for any issues. We would love a review on the Product." | Free text. Default: empty. |
| Send Order card to buyer once an Order is created |
When an order is created in Pipe17, the buyer receives an Order Card from TikTok. |
On / Off. Default: Off. |
| Send messages to certain buyer ID's only | Restrict buyer messages and Order cards to specific buyer IDs. | Free text list. Default: empty. |
Fulfillments
| Setting | Description | Options/Default |
|---|---|---|
| Use fallback carrier if fulfilment carrier does not match supported carriers on TTS | When enabled, a fallback carrier is used when the fulfillment carrier does not match a TTS-supported carrier. | On / Off. Default: Off. |
Products
| Setting | Description | Options/Default |
|---|---|---|
| Force product catalog resync | Triggers a full resync of the product catalog. | On / Off. Default: Off. |
| Only apply product updates for specific SKUs | Limits product updates to the listed SKUs. | Free text list. Default: empty. |
| Prepare for Product Push to TikTok | Helps surface errors and missing attributes on products before enabling Push Products to TTS. Issues are saved on the product and accessible via "Export Incomplete Products" on the Products listing page. Once resolved, Product Push can be enabled. | On / Off. Default: Off. |
| Safe Update for TikTok Product Push | Controls how product updates are pushed to TikTok. When enabled, price updates are handled separately if Hazmat info is missing - only price is updated to avoid delisting. If Hazmat info is available, full product details (including Hazmat) are updated. When off, full updates are pushed but missing Hazmat data could lead to review or delisting. Applies to updates of existing listings only. | On / Off. Default: On. |
| Update only specific product properties | When updates are restricted, update only certain properties such as Price, Description, or Images. | Multi-select. Default: Price, Description. |
| Attributes mapping | Mapping between Pipe17 variant options / custom fields and TikTok sale attributes (for example, color:colour). |
Free text. Default: color:colour. |
| Upload first child product image as variant image | Uploads the first image of a child product as the variant image to TikTok. Works only if Images is an allowed property to update. | On / Off. Default: Off. |
| Allow Pipe17 to deactivate Products that are active in TikTok | Pipe17 product status determines whether a product in TikTok is activated or deactivated. Controlled by mapping defaults and can be overridden via mapping. | On / Off. Default: Off. |
| Allow Pipe17 to recover deleted Products by SKU or Product Id in TikTok instead of creating new one | When enabled, Pipe17 recovers deleted products in TikTok rather than creating a new listing. | On / Off. Default: On. |
| Block update if variants inconsistent | When enabled, Pipe17 will not update product variants on TTS if variants are inconsistent with Pipe17. When disabled, Pipe17 pushes updates and brings TTS variants to parity with Pipe17 - variants not in Pipe17 will be deleted. | On / Off. Default: Off. |
| Choose how Pipe17 handles missing Product attributes | Behavior when required TikTok attributes are missing in Pipe17. With the exception option, an exception is created and the product is created as DRAFT in TTS. With the AI option, Pipe17 uses AI to derive missing values from product properties. | Dropdown. Default: Raise an exception about missing attribute. |
| Pull values only for required attributes | When enabled, only required attribute values are pulled. | On / Off. Default: On. |
| Enter list of Product SKUs for which Pipe17 will apply AI generated product attribute values | Allow list of SKUs for AI-generated attributes. Works only when the AI option is selected for Choose how Pipe17 handles missing Product attributes. | Free text list. Default: empty. |
| Enter black list of Product SKUs for which Pipe17 will NOT apply AI generated product attribute values | Block list of SKUs for AI-generated attributes. Works only when the AI option is selected. | Free text list. Default: empty. |
| Add a list of Product Attributes for which Pipe17 will use AI generated values | Attribute names that AI should fill. Works only when the AI option is selected. | Free text list. Default: empty. |
| Add a Black list of Product Attributes for which Pipe17 will NOT use AI generated values | Attribute names that AI should not fill. Works only when the AI option is selected. | Free text list. Default: empty. |
| Use promotion feature in TikTok | When enabled, Pipe17 creates promotions in TikTok for products with compare_at_price. If compare_at_price is higher than the default price, a promotion is created and the product is shown with a strike-through price. The promotion is removed when compare_at_price is removed or equals the default price. |
On / Off. Default: Off. |
Inventory
| Setting | Description | Options/Default |
|---|---|---|
| Force inventory resync | Triggers a full resync of inventory. | On / Off. Default: Off. |
| Push inventory from a specific location only | When a location is selected, inventory from that location is reported to the default TikTok location. Overrides Send total inventory to a default warehouse id. When no location is selected, reporting depends on Send total inventory to a default warehouse id. | Single-select. Default: none. |
| Send total inventory to a default warehouse id | Works only when no location is selected in Push inventory from a specific location only. When on, inventory totals from all locations in Pipe17 are reported to the default TikTok location. When off, inventory is reported per the mapped locations in Pipe17. | On / Off. Default: On. |
| Only apply inventory updates for specific SKUs | Limits inventory updates to the listed SKUs. | Free text list. Default: empty. |
| Apply TikTok inventory increase only between 12:00AM PST - 2:00AM PST | When enabled, Pipe17 will not post inventory level increases to TikTok until the configured safe time window. | On / Off. Default: Off. |
Returns
| Setting | Description | Options/Default |
|---|---|---|
| Pull returns only when there is a matching order available in Pipe17 | When enabled, returns are pulled only if a matching order exists in Pipe17. | On / Off. Default: Off. |
| Pull returns only with this statuses | TikTok return statuses whose returns are pulled into Pipe17. | Multi-select. Default: Completed (The return processed successfully). |
Refunds
| Setting | Description | Options/Default |
|---|---|---|
| Reason by default for creating refund in TikTok for Delivered orders | Default reason used when creating a refund in TikTok for delivered orders. | Dropdown. Default: Package or product is damaged. |
| Reason by default for creating refund in TikTok for orders in Transit/Awaiting collection status | Default reason used when creating a refund in TikTok for orders in Transit or Awaiting collection. | Dropdown. Default: Missed estimated delivery date. |
| Reason by default for creating cancelation in TikTok for not shipped orders (in Awaiting shipment status) | Default reason used when creating a cancellation in TikTok for orders in Awaiting shipment. | Dropdown. Default: Out of stock. |
| Pull refunds TikTok types | TikTok refund types pulled into Pipe17. | Multi-select. Default: Return and Refund. |
| Pull refunds only with this statuses | TikTok refund statuses whose refunds are pulled into Pipe17. | Multi-select. Default: Completed (The return processed successfully). |
| Reject Buyer Refund Requests for Seller-Initiated Cancellations | Handles cases where a buyer's refund request exists when a cancellation push is sent to TikTok. When enabled, Pipe17 cancels the buyer's refund request and processes the cancellation from the seller's side. | On / Off. Default: Off. |
Statements
| Setting | Description | Options/Default |
|---|---|---|
| Exclude statements created before this date | If specified, only statements created after this date are ingested. If left empty, the integration creation date is used as default. | Date/time. Default: integration creation timestamp. |
Troubleshooting
-
Orders are not appearing in Pipe17
Confirm the order's status is included in Pull orders only with these TikTok statuses and that its creation date is on or after Exclude orders created before this date. If the order is in On Hold, enable Pull Orders in On Hold status. If the order was fulfilled by TTS, enable Pull shipped by platform orders. -
Inventory levels in TikTok do not match Pipe17
Verify how inventory is being reported. If a location is set in Push inventory from a specific location only, that overrides Send total inventory to a default warehouse id. If inventory increases are delayed, check whether Apply TikTok inventory increase only between 12:00AM PST - 2:00AM PST is enabled. Use Force inventory resync to push a fresh snapshot. -
Product updates are causing listings to be reviewed or delisted
Enable Safe Update for TikTok Product Push so price-only updates are sent when Hazmat data is missing. Use Prepare for Product Push to TikTok to surface errors and missing attributes ahead of time, and review the Export Incomplete Products output on the Products listing page. -
Buyer is not receiving order messages or Order cards
Confirm Send a Message to the buyer once an Order is created or Send Order card to buyer once an Order is created is enabled. Check that Message Template is populated and within 2,000 characters. If Send messages to certain buyer ID's only is set, verify the buyer's ID is in the list. -
Refunds or cancellations push with the wrong reason
Review the default reason fields under Refunds: Reason by default for creating refund in TikTok for Delivered orders, Reason by default for creating refund in TikTok for orders in Transit/Awaiting collection status, and Reason by default for creating cancelation in TikTok for not shipped orders (in Awaiting shipment status). The default cancel reasons under Orders (Default cancel reason for line items / Default cancel reason for full order) apply when no reason is provided from the 3PL. -
Cannot consolidate multiple TikTok regions into one connector
This is by design. The TikTok API treats each shop as a separate entity, and the app mirrors that structure. Create a separate integration for each region and use export/import to copy settings, mappings, and rules across them.
Need Help?
If you need additional assistance:
- Use Ask Pippen, our AI agent, located at the top of the app page.
- Submit a support request with as much relevant detail as possible. Learn how to submit a request.
- For urgent issues, email us directly at support@pipe17.com.
We're here to help you succeed with your operations.
Comments
0 comments