eBay Create Or Replace Inventory Item Group
*Summary of Changes:* (The purpose of this table is to keep traceability and Product team to highlight the things that were changed into the scope, based on comments or discussions)
Date | Version | Name | Applied changes |
---|---|---|---|
17.02.2025 | v1.0 | Bogomil Pavlov | First Published |
This call creates a new inventory item group or updates an existing inventory item group. It is up to sellers whether they want to create a complete inventory item group record right from the start, or sellers can provide only some information with the initial createOrReplaceInventoryItemGroup call, and then make one or more additional createOrReplaceInventoryItemGroup calls to complete the inventory item group record. Upon first creating an inventory item group record, the only required elements are the inventoryItemGroupKey identifier in the call URI, and the members of the inventory item group specified through the variantSKUs array in the request payload.
URL: PUT /inventory_item_group/{inventoryItemGroupKey}
Documentation: https://developer.ebay.com/api-docs/sell/inventory/resources/inventory_item_group/methods/createOrReplaceInventoryItemGroup
Sample Request:
PUT https://api.ebay.com/sell/inventory/v1/inventory_item_group/Aweqt
{
"aspects": {
"pattern": [
"solid"
],
"sleeves": [
"short"
]
},
"title": "Men's Solid Polo Shirts",
"description": "Men's solid polo shirts in five colors (Green, Blue, Red, Black, and White), and sizes ranges from small to XL.",
"imageUrls": [
"https://i*****g.com/0**********/**********1.jpg"
],
"variantSKUs": [
"M**S-GrS",
"M**S-GrM",
"M**S-GrL",
"M**S-GrXL",
"M**S-BlS",
"M**S-BlM",
"M**S-BlL",
"M**S-BlXL",
"M**S-RdS",
"M**S-RdM",
"M**S-RdL",
"M**S-RdXL",
"M**S-BkS",
"M**S-BkM",
"M**S-BkL",
"M**S-BkXL",
"M**S-WhS",
"M**S-WhM",
"M**S-WhL",
"M**S-WhXL"
],
"variesBy": {
"aspectsImageVariesBy": [
"Color"
],
"specifications": [
{
"name": "Color",
"values": [
"Green",
"Blue",
"Red",
"Black",
"White"
]
},
{
"name": "Size",
"values": [
"Small",
"Medium",
"Large",
"Extra-Large"
]
}
]
}
}
Request Mapping:
eBay Field | Hemi Field | Required | Comment | |
---|---|---|---|---|
Sample Response: A successful call returns an HTTP status code of 204 and has no response payload.