Sign in
latestOpenAPI 3.1.02026-08-1828105315.1 KB

cc009fec5cdd

Catalog

upsertProducts - Create or Update your Mirakl Connect Catalog

<div class="extension-title">Description</div>

Products 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 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