Skip to main content
inputCreateItemCommandRequestInput

Fields

productGroupId
ID

The ID of the product group to which the item should be assigned. Product groups serve for categorical classification of items for reports and analyses.

shippingClassId
ID

The ID of the shipping class to which the item should be assigned.

manufacturerId
ID

The ID of the manufacturer to which the item should be assigned.

taxClassId
ID

The ID of the tax class to which the item should be assigned. When omitted the item gets the company default. The value must reference an existing tax class - an unknown ID and an explicit null are both rejected as a validation error.

categories

Category assignments of the item. Defines all categories to which the item should be assigned for better organization and navigation.

identifiers

Identifiers of the item with all relevant markings and numbers for unique identification of the item in various systems.

descriptions

Descriptions of the item in different languages and for different platforms/sales channels. Includes names, short and long descriptions as well as SEO-relevant information.

Price structures of the item for different sales channels, customer groups and individual customers. Includes sales prices, purchase prices and tier prices.

Suppliers associated with the item including supplier-specific information such as purchase prices, delivery times and order intervals.

Physical dimensions and weight specifications of the item for storage, shipping and product presentation. Important for shipping cost calculations and storage space optimization.

Custom fields defined for the item to store additional information. Useful for special requirements or integrations.

Variations of an item

Features of an item

Attributes of an item

UnitPricing information of an item

SpecialPrices information of an item

CrosssellingGroups of an item

Images of the item. Not processed by this operation - assign images with PATCH /v2/items/{itemId} once the item exists.

ItemStorageConstraints information of an item

A list of sales channels that should be activated after a successful creation of the item. Omitting the property, sending an empty list and sending null all activate no sales channel. A sales channel that does not resolve to an activatable sales channel is rejected before the item is created, so no item is left behind. A sales channel that resolves but is incompatible with the item is skipped without an error. IncludeItemImages has no effect on this endpoint, because a newly created item has no images to copy.

idempotencyKey
String

Client-supplied idempotency key. When provided, a repeated request with the same key and payload replays the original result instead of re-executing the mutation.