Skip to main content
POST
{micro_service_base_url}
/
inventory-service-v2
/
companies
/
1000019
/
products
/
bulk
Upsert Products using JSON
curl --request POST \
  --url 'https://api.example.com/{{micro_service_base_url}}/inventory-service-v2/companies/1000019/products/bulk' \
  --header 'Content-Type: application/json' \
  --data '
{
  "products": [
    {}
  ]
}
'
This endpoint processes JSON data containing product information and updates your store’s inventory. Products with existing external_id values will be updated, while new external_id values will create new products.
All products will be validated using our validation rules. Only products that pass all rules will be inserted or updated.

​
Body

​
products
array
required
An array of product objects to be created or updated

​
Request Example

[
  {
    "external_id": "22000006660",
    "name": "Wrigley's Gum Slim Pack",
    "price": 179,
    "quantity": 1,
    "category": "Candy",
    "upc": "022000006660",
    "image_url": "https://menu-item-images-bucket.s3.amazonaws.com/resized/7ff6bdd404ed31cfb89c07f2bb51043c.png",
    "description": "15 pieces",
    "brand": "",
    "location": "",
    "active": true,
    "size": "15 pieces",
    "unit_count": ""
  },
  {
    "external_id": "22000017871",
    "name": "Wrigley's Extra Long Lasting Flavor Sugar Free Spearmint",
    "price": 399,
    "quantity": 1,
    "category": "Candy",
    "upc": "022000017871",
    "image_url": "https://menu-item-images-bucket.s3.amazonaws.com/resized/4ff745159f0d5e535d408b707acb7fa9.png",
    "description": "35 count",
    "brand": "",
    "location": "",
    "active": true,
    "size": "35 count",
    "unit_count": ""
  }
]

​
Response

This endpoint processes the data asynchronously. No immediate response body is provided.
The system will process your product data in the background. You can monitor the processing status using the Get Job Status endpoint.
Products with the same external_id as existing products will be updated with the new information provided.