Migrate products from v3 to v5

Changes in the Products API v5

Here is a summary of the changes in the Products API v5:

FieldTypeRequiredNotes
idstringYesRenamed from productID
urlstringYesRenamed from productUrl
pricefloatNoNew field
strikeThroughPricefloatNoNew field
defaultImageUrlstringNoNew field
images[]stringNoType has changed
variants[].idstringYesRenamed from variants[].variantID
variants[].urlstringYesRenamed from variants[].productUrl
variants[].pricefloatNoType has changed
variants[].strikeThroughPricefloatNoRenamed from variants[].oldPrice, type has changed
variants[].descriptionstringNoNew field
variants[].defaultImageUrlstringNoNew field
variants[].images[]stringNoReplaced variants[].imageID

Images

  • We got rid of the imageID field and replaced it with an array of image URLs. This change allows you to provide
    multiple images for a single product or variant in a more straightforward way.
  • defaultImageUrl is a new field that allows you to set a default image for a product or variant.

Prices

  • within new API, prices (price and strikeThroughPrice) are represented as floats. In the previous version, they
    were integers (cents).

Events

The structure for handling events in Omnisend API v5 (link)
differs from v3 (link1, link2)
because v5 offers significantly more flexibility. To ensure a smooth transition for your existing event integrations
when upgrading, you need to

  • add the compatibility: no-origin header to your API calls.

This modification guarantees that your segmentation and automation rules will continue to operate properly.