Add new variants to a merchant catalog
POST
/v1/merchantVariants
or 400 Bad Request for catalog-level validation failures.
Request
Body Params
application/json
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.ordermesh.io/catalog/v1/merchantVariants' \
--header 'Content-Type: application/json' \
--data '{
"merchantCatalogId": "681abd18c61bccfab89bc63e",
"variants": [
{
"id": null,
"sku": "SKU123",
"merchantSku": "MSKU-123",
"merchantPrice": {
"currencies": [
{
"amount": 19.99,
"currency": "USD"
},
{
"amount": 17.99,
"currency": "EUR"
}
],
"amount": 19.99,
"currency": "USD"
},
"skipImageManipulation": null,
"productId": null,
"decorations": [
{
"area": "Front",
"width": 1200,
"height": 800,
"dpi": 300,
"method": "DirectToGarment",
"price": {
"currencies": [
{
"amount": 5.99,
"currency": "USD"
},
{
"amount": 4.99,
"currency": "EUR"
}
],
"amount": 5.99,
"currency": "USD"
},
"printImage": {
"sourcePrintFileUrl": "https://example.com/images/front-print.png",
"imageUploadStatus": null,
"imageUploadStatusDesc": null,
"ourPrintFileId": null,
"ourPrintFileUrl": null
}
}
],
"attributes": [
{
"name": "Color",
"value": "Red"
},
{
"name": "Size",
"value": "Large"
}
]
},
{
"id": null,
"sku": "SKU456",
"merchantSku": "MSKU-456",
"merchantPrice": {
"currencies": [
{
"amount": 24.99,
"currency": "USD"
},
{
"amount": 22.99,
"currency": "EUR"
}
],
"amount": 24.99,
"currency": "USD"
},
"skipImageManipulation": null,
"productId": null,
"decorations": [
{
"area": "Back",
"width": 1000,
"height": 1000,
"dpi": 300,
"method": "DirectToFilm",
"price": {
"currencies": [
{
"amount": 7.99,
"currency": "USD"
},
{
"amount": 6.99,
"currency": "EUR"
}
],
"amount": 7.99,
"currency": "USD"
},
"printImage": {
"sourcePrintFileUrl": "https://example.com/images/back-print.png",
"imageUploadStatus": null,
"imageUploadStatusDesc": null,
"ourPrintFileId": null,
"ourPrintFileUrl": null
}
}
],
"attributes": null
}
]
}'Response Response Example
200 - Success
{
"variantsAdded": 2,
"errors": [
{
"errorMessage": "One or more SKUs do not exist in the catalog and were excluded",
"propertyName": "Variants",
"attemptedValue": [
"invalid-sku-1"
]
}
]
}Modified at 2026-05-27 12:48:51