Catalog
upsertProducts - Create or Update your Mirakl Connect Catalog
Changed onProducts are created if they do not already exist. The missing fields in the request remain unchanged on the Mirakl Connect catalog (behaves like a PATCH).
Omitted top-elements in the API will remain unchanged.
Any nullable field can be explicitly set to null in order to remove its value.
<div class="api-description-extension"> <div class="extension-title">Call Frequency</div> <div class="recommended-call-frequency">Recommended usage: Asynchronous: every 5 minutes</div> <div class="max-call-frequency">Maximum usage: Asynchronous: once per minute</div> </div>post/products
Request
- Base URLhttps://miraklconnect.com/api
- AuthHTTP bearer
- TypeScriptA function with typed inputs. Its response is checked against the schema.
Request body
Example request
{
"products": [
{
"attributes": [
{
"type": "STRING"
}
],
"brand": "My awesome brand",
"category": {
"id": "123654789",
"labels": [
{
"locale": "en_US",
"value": "Fridge"
}
]
},
"descriptions": [
{
"locale": "en_US",
"value": "My awesome product's description"
}
],
"discount_prices": [
{
"end_date": "2025-02-19T16:46:00Z",
"price": {
"currency": "EUR"
},
"start_date": "2025-02-19T16:46:00Z"
}
],
"gtins": [
{
"value": "9780050666319"
}
],
"images": [
{
"url": "http://my_image.png"
}
],
"standard_prices": [
{
"price": {
"currency": "EUR"
}
}
],
"titles": [
{
"locale": "en_US",
"value": "My awesome product"
}
]
}
]
}Response
The request has been accepted
Changes
- breaking
request property
////was restricted to a list of enum values - info
added the new
BOOLEANenum value to the request property//// - info
added the new
NUMERICenum value to the request property//// - info
added the new
STRINGenum value to the request property////
- breaking
- warning
removed the request property
//
- warning