Create Product

Required scope: catalog:write

Creates a catalog product. Prices are integer minor currency units and vatRate is a fraction (for example 0.21 for 21%). Supply countryPrices to set country-specific overrides; each override replaces any existing overrides for its country. The product is active unless isActive is false.

This endpoint is not idempotent: there is no natural key or idempotency key, so repeated calls create duplicate products. De-duplicate on your side (for example by SKU) before retrying.

Generated Reference

POST /public-api/publicapi.v1.Catalog/CreateProduct

Creates a catalog product for external ERP/PIM synchronization. This operation is not idempotent and repeated calls create duplicate products.

Request CreateProductRequest

Response CreateProductResponse

CreateProductRequest

Field	Type	Description
`name`	`string`	Product display name.
`sku`	`string`	Stock keeping unit. May be empty when the catalog does not use SKUs.
`description`	`string`	Free-text product description.
`folder_id`	`optional string`	Catalog folder to place the product in. Root when omitted.
`currency`	`optional string`	ISO 4217 currency code for the base prices.
`price_once_minor`	`optional int32`	One-off price in minor currency units, when the product has one.
`price_monthly_minor`	`optional int32`	Monthly recurring price in minor currency units, when applicable.
`price_yearly_minor`	`optional int32`	Yearly recurring price in minor currency units, when applicable.
`vat_rate`	`optional double`	Default VAT rate as a fraction (for example 0.21 for 21%).
`is_active`	`optional bool`	Whether the product is active and sellable. Defaults to true when omitted.
`min_quantity`	`optional int32`	Minimum orderable quantity, when constrained.
`max_quantity`	`optional int32`	Maximum orderable quantity, when constrained.
`country_prices`	`repeated CountryPriceInput`	Country-specific price overrides. Replaces any existing overrides when set.

CreateProductResponse

Field	Type	Description
`product`	`Product`	The created product.

Related Types

CountryPriceInput

Field	Type	Description
`country_code`	`string`	ISO 3166-1 alpha-2 country code the prices apply to.
`price_once_minor`	`optional int32`	One-off price in minor currency units, when the product has a one-off price.
`price_monthly_minor`	`optional int32`	Monthly recurring price in minor currency units, when applicable.
`price_yearly_minor`	`optional int32`	Yearly recurring price in minor currency units, when applicable.
`vat_rate`	`double`	VAT rate for this country as a fraction (for example 0.21 for 21%).

Product

Field	Type	Description
`id`	`string`
`folder_id`	`optional string`
`name`	`string`
`description`	`string`
`sku`	`string`
`price_once`	`optional int32`
`price_monthly`	`optional int32`
`price_yearly`	`optional int32`
`currency`	`string`
`is_active`	`bool`
`min_quantity`	`optional int32`
`max_quantity`	`optional int32`
`product_kind`	`string`
`country_prices`	`repeated ProductCountryPrice`
`vat_rate`	`double`	Default VAT rate as a fraction (for example 0.21 for 21%).

ProductCountryPrice

Field	Type
`country_code`	`string`
`currency`	`string`
`price_once`	`optional int32`
`price_once_max`	`optional int32`
`price_monthly`	`optional int32`
`price_monthly_max`	`optional int32`
`price_yearly`	`optional int32`
`price_yearly_max`	`optional int32`
`vat_rate`	`double`

Request

{
  "name": "Solar panel",
  "sku": "PV-430",
  "description": "430 W panel",
  "folderId": "<catalog-folder-id>",
  "currency": "EUR",
  "priceOnceMinor": 18900,
  "vatRate": 0.21,
  "isActive": true,
  "minQuantity": 1,
  "countryPrices": [
    { "countryCode": "US", "priceOnceMinor": 20500, "vatRate": 0 }
  ]
}

Response

{
  "product": {
    "id": "<product-id>",
    "name": "Solar panel",
    "sku": "PV-430",
    "priceOnce": 18900,
    "currency": "EUR",
    "vatRate": 0.21,
    "isActive": true
  }
}