Sync TikTok Shop orders

POST /v1/integrations/tiktok-shop/{integrationId}/sync-orders

Manually sync orders from TikTok Shop

Requires: integration.manage

Path Parameters

integrationId required

string

The TikTok Shop integration ID

Request Body

Sync options — `daysBack`, `statusGroups`, and `limit`

TikTokShopSyncOrdersRequest

daysBackoptional

number

Only sync orders created within this many days.

limitoptional

number

Cap on orders imported in this run.

statusGroupsoptional

any[]

Which fulfillment stages to include. Maps to TikTok order_status: - 'awaiting' → AWAITING_SHIPMENT + AWAITING_COLLECTION (needs action) - 'in_transit' → IN_TRANSIT (shipped) - 'completed' → DELIVERED + COMPLETED

Example Request

application/json

{
  "limit": 1,
  "daysBack": 1,
  "statusGroups": []
}

Response Schema

TikTokShopSyncOrdersResult

ordersrequired

object[]

cancelledAtoptional

string

createdAtrequired

string

format: date-time

currencyoptional

string

customerIdoptional

string

deadlineoptional

string

externalIdoptional

string

externalUrloptional

string

idrequired

string

pattern: ^[a-z0-9]{24}$

integrationIdoptional

string

noteoptional

string

orderNumberrequired

string

priceoptional

number

priceBucketoptional

number

processedAtoptional

string

shippedAtoptional

string

sourceoptional

any

sourceRefoptional

string

statusrequired

any

storeIdrequired

string

pattern: ^[a-z0-9]{24}$

syncDisabledrequired

boolean

updatedAtrequired

string

format: date-time

skippedrequired

number

totalAvailablerequired

number

totalSyncedrequired

number

Example Response

201 OK — application/json

{
  "orders": [
    {
      "orderNumber": "string",
      "syncDisabled": true,
      "id": "string",
      "storeId": "string",
      "createdAt": "2026-08-24T03:58:56.441Z",
      "updatedAt": "2026-08-24T03:58:56.441Z"
    }
  ],
  "totalSynced": 1,
  "totalAvailable": 1,
  "skipped": 1
}