PUT v1/Products

Update an existing Product.

Request Information

Requires Authorization!

URI Parameters

None.

Body Parameters

The product.

Name	Description	Type	Additional information
SyncProductGroupsOnSave	Set this property to true, to update the ProductGroups collection when saving.	boolean	None.
SyncPropertiesOnSave	Set this property to true, to update the Properties collection when saving.	boolean	None.
ShopGroupId	Gets or sets the shop group identifier.	integer	Required
EAN	Gets or sets the European Article Number.	string	None.
Note	Gets or sets the note.	string	Max length: 2147483647
CustomerMustAskForPrice	Gets or sets a value indicating whether the customer should not see the price, but must explicitly ask for it.	boolean	Required
ProductVariantParentId	Gets or sets the creation date. The Id to the ProductVariant parent. The Type of the product should be ProductVariant (2) when used.	integer	None.
VariantInfo	This field contains a summary of the values of the Variation properties. This field is only used when the Type = ProductVariant (2). Eg: 'Black \| XL'	string	Max length: 100
CreationDate	Gets the creation date.	date	Required
ChangedTimestamp	Gets the changed timestamp.	date	None.
MainImageFileId	Gets or sets the main image file identifier.	integer	None.
KeepStock	Gets or sets a value indicating whether [keep stock].	boolean	Required
MinimumStock	Gets or sets the minimum stock.	decimal number	Required
SyncEnabled	Gets or sets a value indicating whether [synchronize enabled].	boolean	Required
Published	Gets or sets a value indicating whether this is published.	boolean	Required
Weight	Gets or sets the weight.	decimal number	None.
WeightUOMId	Gets or sets the weight uom identifier.	integer	None.
Height	Gets or sets the height.	decimal number	None.
HeightUOMId	Gets or sets the height uom identifier.	integer	None.
Length	Gets or sets the length.	decimal number	None.
LengthUOMId	Gets or sets the length uom identifier.	integer	None.
Width	Gets or sets the width.	decimal number	None.
WidthUOMId	Gets or sets the width uom identifier.	integer	None.
PriceExVat	Gets or sets the price ex vat.	decimal number	Required
ProductPropertyDefSetId	Gets or sets the product property definition set identifier.	integer	None.
ProductGroups	Gets or sets the product groups.	Collection of integer	None.
Properties	A collection of translatable Product Properties. Following property codes are system properties which can be used: "Name", "Description", "Published", "DescriptionLong", "MetaTitle", "MetaKeywords", "MetaDescription", "NameTemplate", "DescriptionTemplate", "DescriptionLongTemplate"	Collection of ProductProperty	None.
ProductVariantPropertyDefIds	This collection holds the Id's of ProductPropertyDefinitions which are used to create Product Variants for. This collection is only used when the Product is of the Type ProductVariantParent.	Collection of integer	None.
ProductVariantIds	This collection holds the Id's of the (child) Product Variants. This collection is only used when the Product is of the Type ProductVariantParent.	Collection of integer	None.
Id	Gets or sets the identifier.	integer	Required
Code	Gets or sets the code.	string	Required Max length: 50
Name	Gets or sets the name.	string	Max length: 400
Type	The ProductType, available: SimpleProduct = 0, ProductVariantParent = 1, ProductVariant = 2	integer	None.

Request Formats

application/json, text/json

Sample:

{
  "SyncProductGroupsOnSave": true,
  "SyncPropertiesOnSave": true,
  "ShopGroupId": 3,
  "EAN": "sample string 4",
  "Note": "sample string 5",
  "CustomerMustAskForPrice": true,
  "ProductVariantParentId": 1,
  "VariantInfo": "sample string 7",
  "CreationDate": "2026-04-03T18:30:48.6438586+02:00",
  "ChangedTimestamp": "2026-04-03T18:30:48.6438586+02:00",
  "MainImageFileId": 1,
  "KeepStock": true,
  "MinimumStock": 10.0,
  "SyncEnabled": true,
  "Published": true,
  "Weight": 1.0,
  "WeightUOMId": 1,
  "Height": 1.0,
  "HeightUOMId": 1,
  "Length": 1.0,
  "LengthUOMId": 1,
  "Width": 1.0,
  "WidthUOMId": 1,
  "PriceExVat": 13.0,
  "ProductPropertyDefSetId": 1,
  "ProductGroups": [
    1,
    2
  ],
  "Properties": [
    {
      "CultureId": 1,
      "ShopId": 1,
      "ProductPropertyDefId": 1,
      "Code": "sample string 2",
      "Value": "sample string 3"
    },
    {
      "CultureId": 1,
      "ShopId": 1,
      "ProductPropertyDefId": 1,
      "Code": "sample string 2",
      "Value": "sample string 3"
    }
  ],
  "ProductVariantPropertyDefIds": [
    1,
    2
  ],
  "ProductVariantIds": [
    1,
    2
  ],
  "Id": 14,
  "Code": "sample string 15",
  "Name": "sample string 16",
  "Type": 17
}

application/xml

Sample:

Sample not available.

text/xml

Sample:

Sample not available.

Response Information

Response Codes

OK (200)

Resource Description

The HttpResponseMessage object.

HttpResponseMessage

Name	Type	Additional information
Version	Version	None.
Content	HttpContent	None.
StatusCode	HttpStatusCode	None.
ReasonPhrase	string	None.
Headers	Collection of Object	None.
RequestMessage	HttpRequestMessage	None.
IsSuccessStatusCode	boolean	None.