Push Products to WMS
POST/api/trackstar/integration-instances/:integration_instance/products/push
Queue a push of SKU products into the WMS as the tracked job Push Products to Trackstar: {instance_name} (queue batch); follow its progress through the tracked job log. Nothing is written to the WMS by this request itself. Only one push per connection runs at a time.
This endpoint currently requires session authentication; Personal Access Token scope support is in progress.
Body: all (bool — push everything from products/pushable, resolved server-side) OR sku_product_ids (int[]); update_existing (bool, default false — legacy Logiwa only: re-send products the WMS already has; Logiwa's InsertInventoryItem OVERWRITES the existing item's fields. Ignored for create_product connections, which never update); warehouse_customer_id (string, required when the connection has more than one warehouse customer); logiwa {consumer_unit, pack_unit, item_type} (optional overrides for the Logiwa lookups, default UNIT / UNIT / Purchased).
Before a create-only Logiwa push, SKU asks Logiwa which item codes the warehouse customer already holds and skips them; if Logiwa can't be read, nothing is sent. Logiwa items are sent 50 per call, paced ≥1.2s apart, with Logiwa throttle replies retried; weights go as ounces and dimensions as inches. After anything is pushed, the job asks Trackstar to re-crawl products and queues a products sync. Per-product outcomes (pushed / skipped / failed with a reason) are in the tracked job's results.
409 when a push to this connection is already running. 422 when the WMS can't take product writes, when a warehouse customer must be chosen, or when warehouse_customer_id isn't on the connection. Requires Bearer token and the integrations.update permission.
Request
Responses
- 200
- 401
- 403
- 404
- 422
- 429
OK
Response Headers
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.
Not found — no record with the given identifier (or the route does not exist). Verify the ID before retrying.
Unprocessable Entity
Response Headers
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.