v1

latestOpenAPI 3.1.02026-07-22802,2441.7 MB
wms
Products

Create Product

Get the required, optional, and integration specific fields by calling the integrations endpoint.

post/wms/products

Headers

x-trackstar-api-keystring required
Example:<x-trackstar-api-key>

Your organization-level Trackstar API key.

x-trackstar-access-tokenstring required
Example:<x-trackstar-access-token>

Your user's access token for a specific integration (ShipHero, Extensiv, etc).

Request body

OR
OR
OR
OR
OR
OR
OR
OR
OR
OR
OR
OR
OR
OR
OR
OR
OR
OR
OR
OR
OR
OR
OR
OR
OR
OR
OR
OR
OR
OR
OR

Example request

{
  "trackstar_tags": [
    "tag1",
    "tag2",
    {
      "tag3": "value3"
    }
  ],
  "sku": "sku",
  "name": "name",
  "gtin": "gtin",
  "measurements": {
    "length": 1.5,
    "width": 1.5,
    "height": 1.5,
    "unit": "in",
    "weight": 2.5,
    "weight_unit": "lb"
  }
}

Response

Successful response

idstring required

The ID of the object that has been created or modified

unused_fieldsstring[] required

Unused fields

Example response

{
  "data": {
    "id": "product_id",
    "warehouse_customer_id": "warehouse_customer_id",
    "created_date": "2022-01-01T00:00:00Z",
    "updated_date": "2022-01-02T05:05:05Z",
    "name": "name",
    "sku": "sku",
    "gtin": "gtin",
    "unit_price": 10.99,
    "inventory_items": [
      {
        "inventory_item_id": "id1",
        "sku": "sku1",
        "unit_quantity": 1
      },
      {
        "inventory_item_id": "id2",
        "sku": "sku2",
        "unit_quantity": 1
      }
    ],
    "is_kit": true,
    "active": true,
    "supplier_object": {
      "supplier_id": "supplier_id",
      "supplier_name": "supplier_name"
    },
    "country_of_origin": "USA",
    "harmonized_code": "123456",
    "supplier_products": [
      {
        "supplier_id": "id1",
        "supplier_name": "name1",
        "external_id": "ext_id1",
        "unit_cost": 1
      },
      {
        "supplier_id": "id2",
        "supplier_name": "name2",
        "external_id": "ext_id2",
        "unit_cost": 2.5
      }
    ],
    "categories": [
      "Electronics",
      "Accessories"
    ],
    "image_urls": [
      "https://example.com/image1.jpg"
    ],
    "external_system_url": "https://example.com/product/123",
    "trackstar_tags": [
      "tag1",
      "tag2",
      {
        "tag3": "value3"
      }
    ],
    "additional_fields": {
      "key": "value"
    }
  },
  "id": "id"
}