> ## Documentation Index
> Fetch the complete documentation index at: https://developer.jtl-software.com/llms.txt
> Use this file to discover all available pages before exploring further.

# CreateRegularItemCommandRequestInput

> Creates a new RegularItem in one call. The request carries exactly the fields of this kind: mandatory ones, optional ones, and none of those the kind does not have. The item is valid right away: item number, name, at least one category and the mandatory fields of the kind are required. Everything else, such as prices, descriptions in further languages, suppliers and images, is added through its own sub-resource. - Request



**Kind**: `input`

## Fields

**`name`**: `String!` (required)

Name of the item in the default language. Further languages and sales channel texts are the descriptions of the item.

---

**`identifiers`**: `TradeItemIdentifiersInput!` (required)

The identifiers of the item. The item number (SKU) is mandatory and unique.

---

**`categoryIds`**: `[ID]!` (required)

The IDs of the categories the new item is assigned to. At least one: every item that is not a combination of a variation parent has a category, and an item without one is not valid (an empty list is refused with 400). A combination takes over the categories of its parent and is created through the combinations of the parent, which have no such field. Further assignments are made through the categories of the item.

---

**`isActive`**: `Boolean`

Whether the item is active. Defaults to true when omitted.

---

**`productGroupId`**: `ID`

The ID of the product group.

---

**`manufacturerId`**: `ID`

The ID of the manufacturer.

---

**`conditionId`**: `ID`

The ID of the item condition, for example new or used.

---

**`deliveryStatusId`**: `ID`

The ID of the delivery status of the item (the master data of delivery statuses, for example "in stock" or "ships in 3 days").

---

**`taxClassId`**: `ID`

The ID of the tax class. When omitted the item gets the company default. The value must reference an existing tax class.

---

**`shippingClassId`**: `ID`

The ID of the shipping class.

---

**`dimensions`**: `ItemDimensionsInput`

Outer dimensions as shipped.

---

**`weights`**: `ItemWeightsInput`

Weights.

---

**`customs`**: `ItemCustomsInput`

Customs information.

---

**`units`**: `ItemUnitsInput`

Sales unit and content with its base price.

---

**`containers`**: `[NewItemContainerInput]`

The containers the item is also traded in.

---

**`descriptions`**: `[NewItemDescriptionInput]`

The default texts of the item, one per language.

---

**`characteristicValueIds`**: `[ID]`

The characteristic values (German 'Merkmalwerte') assigned to the item. Omitted means none.

---

**`attributes`**: `[ItemAttributeInput]`

The attribute values of the item, per attribute, sales channel and language. Omitted means none. The attributes the system derives itself, such as those of a voucher, cannot be sent.

---

**`customFields`**: `[ItemCustomFieldInput]`

The custom field values of the item. Omitted means none. A custom field has to apply to the item, which depends on its product group.

---

**`freeTextVariations`**: `[NewFreeTextVariationInput]`

The free-text variations of the item (German 'Freitext'), added in the same call. Every kind can have them. Omitted means none. Refused with 409 for an item of the fulfillment network.

---

**`selectionVariations`**: `[NewSelectionVariationInput]`

The simple selection variations of the item with their values, added in the same call. Only the kinds that allow them have this field; the reasons that forbid them for a given item are in 409 SELECTION_VARIATION_NOT_ALLOWED_FOR_ITEM_TYPE. Omitted means none.

---

**`salesChannels`**: `[SalesChannelActivationInput]`

The sales channels the item is activated in, set in the same call. The item has to be in a category that is active in each of them. Omitted means none; the item is activated afterwards through its sales channels.

---

**`prices`**: `NewItemPricesInput`

The prices of the item, created in the same call. Every part is the model of the matching prices route. Omitted means the item is created without prices and they are set through those routes.

---

**`disableAutomaticWorkflows`**: `Boolean`

Suppresses the automatic workflow triggers of this call. Defaults to false when omitted.

---

**`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.