Map Product to SKU.io Product
PUT/api/trackstar/integration-instances/:integration_instance/products/:product/mapping
Link a Trackstar (WMS) product to the SKU.io product it represents, for warehouses whose SKUs differ from your catalog. The mapping replaces the exact-SKU match everywhere the two are joined: orders sent to the warehouse use the mapped Trackstar product and its own SKU, inbound shipments are received under that SKU, inventory comparisons count its stock for the SKU.io product, and the product push treats the SKU.io product as already at the warehouse.
This endpoint currently requires session authentication; Personal Access Token scope support is in progress.
One SKU.io product can be mapped to only one Trackstar product per connection — mapping it a second time returns 422 naming the existing mapping.
Body:
- sku_product_id (required, integer): an existing SKU.io product id
Requires 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
Response Headers
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.