Skip to main content
POST
Creates a new item that is a stock item from the start, so that its stock is managed in warehouses.

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Headers

Idempotency-Key
string

Optional, client-generated key for deduplicating repeated write requests. A repeated request with the same key returns the originally recorded result instead of executing the effect again.

Required string length: 1 - 255
x-tenant-id
string<uuid>
required

The tenant ID for the target ERP instance.

Body

application/json

Request model for CreateStockItem command endpoint. Route parameters bind from the route, query parameters from the query string, everything else from the body.

categories
object
required

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

identifiers
object
required

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

descriptions
object
required

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.

stockManagement
object
required

Stock management configuration of the item. Mandatory - it is what makes this a stock item, and it replaces the optional storageConstraints block and its isInventoryManagementActive switch on POST /v2/items.

productGroupId
string<uuid>

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.

Example:

"b45f6432-2462-4c6f-b00f-1d9d01000000"

shippingClassId
string<uuid>

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

Example:

"b45f6432-2462-4c6f-b00f-1d9d01000000"

manufacturerId
string<uuid>

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

Example:

"b45f6432-2462-4c6f-b00f-1d9d01000000"

prices
object

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

suppliers
object

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

measurements
object

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

customFields
object

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

variations
object

Variations of an item

features
object

Features of an item

attributes
object

Attributes of an item

unitPricing
object

UnitPricing information of an item

specialPrices
object

SpecialPrices information of an item

crosssellingGroups
object

CrosssellingGroups of an item

Response

Stock item was successfully created

Creates a new item that is a stock item from the start, so that its stock is managed in warehouses. Takes the same properties as POST /v2/items, except for three: the optional storageConstraints block is replaced by a mandatory stockManagement block, images are not part of this request - assign them with PATCH /v2/items/{itemId} once the item exists - and salesChannels is not either, activate channels with POST /v2/items/{itemId}/sales-channels/{salesChannelId}/activate. Use POST /v2/items/{itemId}/stock-items/convert to turn an item that already exists into a stock item. - Response

itemId
string<uuid>
required

Unique ID of the newly created stock item - this key is used for all further operations with the item.

Example:

"b45f6432-2462-4c6f-b00f-1d9d01000000"