v50

latestOpenAPI 3.0.0raw.githubusercontent.com2026-05-29208421.4 MB

SKU

Create SKU

Creates a new SKU.

If there is a need to create a new SKU with a specific custom ID, specify the Id (integer) in the request. Otherwise, VTEX will generate the ID automatically.

Permissions

Any user or API key must have at least one of the appropriate License Manager resources to be able to successfully run this request. Otherwise they will receive a status code 403 error. These are the applicable resources for this endpoint:

Product	Category	Resource
Catalog	Content	SKUs

There are no applicable predefined roles for this resource list. You must create a custom role and add at least one of the resources above in order to use this endpoint. To learn more about machine authentication at VTEX, see Authentication overview.

❗ To prevent integrations from having excessive permissions, consider the best practices for managing API keys when assigning License Manager roles to integrations.

post/api/catalog/pvt/stockkeepingunit

Headers

Content-Typestring required

Type of the content being sent.

Acceptstring required

HTTP Client Negotiation Accept Header. Indicates the types of responses the client can understand.

Request body

Idinteger

SKU unique identifier. If not informed, it will be automatically generated by VTEX.

ProductIdinteger required

ID of the product associated with this SKU.

IsActiveboolean

Defines if the SKU is active (true) or not (false). During SKU creation, do not set this field as true or you will receive a 400 Bad Request error. You should activate the SKU afterwards, as explained in Activating an SKU.

ActivateIfPossibleboolean

When set to true, this attribute will automatically update the SKU as active once associated with an image or an active component. We recommend setting it to true, unless you plan to have an internal workflow to manually activate SKUs.

Namestring required

SKU name, meaning the variation of the previously added product. For example: Product - Fridge, SKU - 110V. Limited to 200 characters.

RefIdstring

Reference code used internally for organizational purposes. Must be unique. Required only if Ean is not informed, but can be used alongside Ean as well. The limit for the SKU RefId is 50 characters.

PackagedHeightnumber required

Height used for shipping calculation.

PackagedLengthnumber required

Length used for shipping calculation.

PackagedWidthnumber required

Width used for shipping calculation.

PackagedWeightKginteger required

Weight used for shipping calculation, in the measurement configured in the store, which by default is in grams. Do not fill in this field with 0 or null, because this might result in shipping issues.

Heightnumber

SKU real height.

Lengthnumber

SKU real length.

Widthnumber

SKU real width.

WeightKgnumber

Weight of the SKU in the measurement configured in the store, which by default is in grams.

CubicWeightnumber

Cubic weight.

IsKitboolean

Defines whether the SKU is made up of one or more SKUs (part of a kit) (true) or not (false). Must be enabled if you are adding a kit. Once activated, this definition cannot be reverted.

CreationDatestring

Date and time of the SKU's creation.

RewardValuenumber

Credit that the customer receives when finalizing an order that includes the SKU. By filling this field out with 1, the customer receives credit on the site in the selected currency, e.g. U$ 1.

EstimatedDateArrivalstring nullable

To add the product as pre-sale, enter the product estimated arrival date in ISO-8601 format. You must take into consideration both the launch date and the freight calculation for the arrival date.

ManufacturerCodestring

Identifier provided by the manufacturers to identify their product. This field should be filled in if the product has a specific manufacturer's code.

CommercialConditionIdinteger

Commercial condition ID, used to define SKU specific promotions or installment rules. In case of no specific condition, use 1 (default value). This field does not accept 0. Learn more at Registering a commercial condition.

MeasurementUnit'un' | 'kg' | 'g' | 'mg' | 'm' | 'm²' | 'm³' | 'cm' | 'cm²' | 'cm³' | 'mm' | 'mm²' | 'mm³' | 'oz' | 'lb' | 'ft' | 'ft²' | 'ft³' | 'in' | 'in²' | 'in³'

Measurement unit. This field should only be used when it is necessary to convert the unit of measure for sale. In common cases, use un (unit).

The acceptables values are:

un: Unit
kg: Kilogram
g: Gram
mg: Milligram
m: Meter
m²: Square meter
m³: Cubic meter
cm: Centimeter
cm²: Square centimeter
cm³: Cubic centimeter
mm: Millimeter
mm²: Square millimeter
mm³: Cubic millimeter
oz: Ounce
lb: Pound
ft: Foot
ft²: Square foot
ft³: Cubic foot
in: Inch
in²: Square inch
in³: Cubic inch

UnitMultipliernumber

Multiple number of SKU. If the multiplier is 5.0000, the product can be added in multiple quantities of 5, 10, 15, 20, onward.

ModalTypestring nullable

Links an unusual type of SKU that needs special transportation, such as meat, glass, or a mattress, to a carrier specialized in delivering it. This field should be filled in with the name of the modal (e.g. "Chemicals" or "Refrigerated products"). To learn more about this feature, read our articles How the modal works and Setting up modal for carriers.

KitItensSellApartboolean

Defines if kit components can be sold apart.

Videosstring[]

Videos URLs.

Example request

{
  "Id": 1,
  "ProductId": 42,
  "ActivateIfPossible": true,
  "Name": "Size 10",
  "RefId": "B096QW8Y8Z",
  "PackagedHeight": 10,
  "PackagedLength": 10,
  "PackagedWidth": 10,
  "PackagedWeightKg": 10,
  "Height": 1,
  "Length": 1,
  "Width": 1,
  "WeightKg": 1,
  "CubicWeight": 0.1667,
  "CreationDate": "2020-01-25T15:51:29.2614605",
  "RewardValue": 1,
  "ManufacturerCode": "123",
  "CommercialConditionId": 1,
  "MeasurementUnit": "un",
  "UnitMultiplier": 2,
  "Videos": [
    "https://www.youtube.com/"
  ]
}

Response

Idinteger

SKU unique identifier.

ProductIdinteger

ID of the product associated with this SKU.

IsActiveboolean

Defines if the SKU is active (true) or not (false).

ActivateIfPossibleboolean

When set to true, this attribute will automatically update the SKU as active once associated with an image or an active component.

Namestring

SKU name, meaning the variation of the previously added product. For example: Product - Fridge, SKU - 110V.

RefIdstring

Reference code used internally for organizational purposes. Must be unique. Required only if Ean is not informed, but can be used alongside Ean as well.

PackagedHeightnumber

Height used for shipping calculation.

PackagedLengthnumber

Length used for shipping calculation.

PackagedWidthnumber

Width used for shipping calculation.

PackagedWeightKginteger

Weight used for shipping calculation, in the measurement unit configured in the store, which by default is in grams.

Heightnumber

SKU real height.

Lengthnumber

SKU real length.

Widthnumber

SKU real width.

WeightKgnumber

Weight of the SKU in the measurement unit configured in the store, which by default is in grams.

CubicWeightnumber

Cubic weight.

IsKitboolean

Defines whether the SKU is made up of one or more SKUs (part of a kit) (true) or not (false). Must be enabled if you are adding a kit. Once activated, this definition cannot be reverted.

CreationDatestring

Date and time of the SKU's creation.

RewardValuenumber

Credit that the customer receives when finalizing an order that includes the SKU. By filling this field out with 1, the customer receives credit on the site in the selected currency, e.g. U$ 1.

EstimatedDateArrivalstring nullable

SKU estimated arrival date in ISO-8601 format, when the product is on pre-sale. You must take into consideration both the launch date and the freight calculation for the arrival date.

ManufacturerCodestring

Identifier provided by the manufacturers to identify their product. This field should be filled in if the product has a specific manufacturer's code.

CommercialConditionIdinteger

MeasurementUnitstring

Measurement unit. This field should only be used when it is necessary to convert the unit of measure for sale. For example, if a product is sold in boxes, but customers want to buy per square meter (m²). In common cases, use 'un'.

UnitMultipliernumber

Multiple number of SKU. If the multiplier is 5.0000, the product can be added in multiple quantities of 5, 10, 15, 20, onward.

ModalTypestring nullable

KitItensSellApartboolean

Defines if kit components can be sold apart.

Videosstring[]

Videos URLs.