---
title: "Creates one or more duplicates of an existing item with specified duplication options."
method: POST
path: "/v2/DuplicateItems"
tags: ["DuplicateItemCommand"]
---

# Creates one or more duplicates of an existing item with specified duplication options.

`POST /v2/DuplicateItems`

## Headers

- `x-tenant-id` string, uuid, required
- `x-runas` string
- `x-companyid` string

## Request body

- JTLWawiItemPublicApiDataTransferObjectsV2DuplicateItemDuplicateItemsCommandRequest — Creates one or more duplicates of an existing item with specified duplication options. - Request
  - `duplicateItemId` string, uuid
  - `duplicatesToCreate` JTLWawiItemPublicApiDataTransferObjectsV2DuplicateItemCreateItemDuplicate[] — The basic information (SKU and name) for the items to be created as duplicates.
    - `sku` string — The stock keeping unit (SKU) for the duplicated item. Must be unique.
    - `name` string — The name of the duplicated item.
  - `executeItemCreatedWorkflowOnCreation` boolean — Indicates whether the item creation workflow should be executed after creating the duplicates.
  - `itemDuplicationOptions` JTLWawiItemPublicApiDataTransferObjectsV2DuplicateItemCreateItemDuplicationOptions — Defines which item properties should be duplicated when creating item copies. This structure controls the duplication behavior for all relevant item aspects.
    - `oversalesDuplicationOptions` JTLWawiItemPublicApiDataTransferObjectsV2DuplicateItemCreateOversalesDuplicationOptions — Options for duplicating over-sales settings.
      - `isActive` boolean — Indicates whether over-sales settings should be duplicated.
    - `attributesDuplicationOptions` JTLWawiItemPublicApiDataTransferObjectsV2DuplicateItemCreateAttributesDuplicationOptions — Options for duplicating item attributes.
      - `isActive` boolean — Indicates whether item attributes should be duplicated.
    - `imagesDuplicationOptions` JTLWawiItemPublicApiDataTransferObjectsV2DuplicateItemCreateImagesDuplicationOptions — Options for duplicating images.
      - `isActive` boolean — Indicates whether images should be duplicated.
    - `downloadFilesDuplicationOptions` JTLWawiItemPublicApiDataTransferObjectsV2DuplicateItemCreateDownloadFilesDuplicationOptions — Options for duplicating download files.
      - `isActive` boolean — Indicates whether download files should be duplicated.
    - `uploadFilesDuplicationOptions` JTLWawiItemPublicApiDataTransferObjectsV2DuplicateItemCreateUploadFilesDuplicationOptions — Options for duplicating upload files.
      - `isActive` boolean — Indicates whether upload files should be duplicated.
    - `mediaFilesDuplicationOptions` JTLWawiItemPublicApiDataTransferObjectsV2DuplicateItemCreateMediaFilesDuplicationOptions — Options for duplicating media files.
      - `isActive` boolean — Indicates whether media files should be duplicated.
    - `characteristicsDuplicationOptions` JTLWawiItemPublicApiDataTransferObjectsV2DuplicateItemCreateCharacteristicsDuplicationOptions — Options for duplicating item characteristics.
      - `isActive` boolean — Indicates whether item characteristics should be duplicated.
    - `bomDuplicationOptions` JTLWawiItemPublicApiDataTransferObjectsV2DuplicateItemCreateBomDuplicationOptions — Options for duplicating bill of materials components.
      - `isActive` boolean — Indicates whether bill of materials components should be duplicated.
    - `variationsDuplicationOptions` JTLWawiItemPublicApiDataTransferObjectsV2DuplicateItemCreateVariationsDuplicationOptions — Options for duplicating variations.
      - `isActive` boolean — Indicates whether variations should be duplicated.
    - `configurationsDuplicationOptions` JTLWawiItemPublicApiDataTransferObjectsV2DuplicateItemCreateConfigurationsDuplicationOptions — Options for duplicating configurations.
      - `isActive` boolean — Indicates whether configurations should be duplicated.
    - `descriptionsDuplicationOptions` JTLWawiItemPublicApiDataTransferObjectsV2DuplicateItemCreateDescriptionsDuplicationOptions — Options for duplicating descriptions.
      - `isActive` boolean — Indicates whether descriptions should be duplicated.
      - `considerDescriptions` boolean — Indicates whether the item description should be considered during duplication. When true, the full description text will be duplicated.
      - `considerMetadata` boolean — Indicates whether the item metadata (such as meta description, meta keywords, and title tags) should be considered during duplication.
      - `considerUrlPaths` boolean — Indicates whether the URL path should be considered during duplication. When true, the SEO-friendly URL path will be duplicated.
      - `considerNames` boolean — Indicates whether the item name should be considered during duplication. When true, the item name from descriptions will be duplicated.
    - `crossSellingDuplicationOptions` JTLWawiItemPublicApiDataTransferObjectsV2DuplicateItemCreateCrossSellingDuplicationOptions — Options for duplicating cross-selling data.
      - `isActive` boolean — Indicates whether cross-selling data should be duplicated.
    - `customFieldsDuplicationOptions` JTLWawiItemPublicApiDataTransferObjectsV2DuplicateItemCreateCustomFieldsDuplicationOptions — Options for duplicating custom fields.
      - `isActive` boolean — Indicates whether custom fields should be duplicated.
    - `purchasePricesDuplicationOptions` JTLWawiItemPublicApiDataTransferObjectsV2DuplicateItemCreatePurchasePricesDuplicationOptions — Options for duplicating purchase prices.
      - `isActive` boolean — Indicates whether purchase prices should be duplicated.
    - `identifiersDuplicationOptions` JTLWawiItemPublicApiDataTransferObjectsV2DuplicateItemCreateIdentifiersDuplicationOptions — Options for duplicating identifiers.
      - `isActive` boolean — Indicates whether identifiers should be duplicated.
      - `considerEan` boolean — Indicates whether the EAN (European Article Number) should be considered during duplication.
      - `considerIsbn` boolean — Indicates whether the ISBN (International Standard Book Number) should be considered during duplication.
      - `considerUpc` boolean — Indicates whether the UPC (Universal Product Code) should be considered during duplication.
      - `considerHan` boolean — Indicates whether the HAN (manufacturer number) should be considered during duplication.
      - `considerTaricCode` boolean — Indicates whether the TARIC code should be considered during duplication.
      - `considerCountryCode` boolean — Indicates whether the country of origin code should be considered during duplication.
      - `considerHazardNumber` boolean — Indicates whether the hazard identification number should be considered during duplication.
      - `considerSeries` boolean — Indicates whether the series information should be considered during duplication.
      - `considerUnNumber` boolean — Indicates whether the UN number should be considered during duplication.
      - `considerAmazonFnsku` boolean — Indicates whether the Amazon FNSKU should be considered during duplication.
      - `considerNotes` boolean — Indicates whether item notes should be considered during duplication.
      - `considerSearchTerms` boolean — Indicates whether search terms should be considered during duplication.
      - `considerIncludeInPriceList` boolean — Indicates whether the include in price list flag should be considered during duplication.
      - `considerOrderSuggestions` boolean — Indicates whether order suggestions should be considered during duplication.
    - `salesPricesDuplicationOptions` JTLWawiItemPublicApiDataTransferObjectsV2DuplicateItemCreateSalesPricesDuplicationOptions — Options for duplicating sales prices.
      - `isActive` boolean — Indicates whether sales prices should be duplicated.
    - `masterDataDuplicationOptions` JTLWawiItemPublicApiDataTransferObjectsV2DuplicateItemCreateMasterDataDuplicationOptions — Options for duplicating master data.
      - `isActive` boolean — Indicates whether master data should be duplicated.
      - `considerManufacturer` boolean — Indicates whether the manufacturer should be considered during duplication.
      - `considerProductGroup` boolean — Indicates whether the product group should be considered during duplication.
      - `considerTaxClass` boolean — Indicates whether the tax class should be considered during duplication.
      - `considerShippingClass` boolean — Indicates whether the shipping class should be considered during duplication.
      - `considerBasePriceUnit` boolean — Indicates whether the base price unit should be considered during duplication.
      - `considerMinimumPurchaseSettings` boolean — Indicates whether minimum purchase settings should be considered during duplication.
      - `considerPackaging` boolean — Indicates whether packaging information should be considered during duplication.
      - `considerNonDiscountable` boolean — Indicates whether the non-discountable flag should be considered during duplication.
      - `considerItemType` boolean — Indicates whether the item type should be considered during duplication.
      - `considerInventoryManagement` boolean — Indicates whether inventory management settings should be considered during duplication.
      - `considerMinMaxInventory` boolean — Indicates whether minimum and maximum inventory levels should be considered during duplication.
      - `considerProductCompliancePerson` boolean — Indicates whether the product compliance responsible person should be considered during duplication.
    - `specialPricesDuplicationOptions` JTLWawiItemPublicApiDataTransferObjectsV2DuplicateItemCreateSpecialPricesDuplicationOptions — Options for duplicating special prices.
      - `isActive` boolean — Indicates whether special prices should be duplicated.
    - `deliveryOptionsDuplicationOptions` JTLWawiItemPublicApiDataTransferObjectsV2DuplicateItemCreateDeliveryOptionsDuplicationOptions — Options for duplicating delivery options.
      - `isActive` boolean — Indicates whether delivery options should be duplicated.
    - `measurementssDuplicationOptions` JTLWawiItemPublicApiDataTransferObjectsV2DuplicateItemCreateMeasurementssDuplicationOptions — Options for duplicating dimensions and weights.
      - `isActive` boolean — Indicates whether dimensions and weights should be duplicated.
    - `suppliersDuplicationOptions` JTLWawiItemPublicApiDataTransferObjectsV2DuplicateItemCreateSuppliersDuplicationOptions — Options for duplicating supplier data.
      - `isActive` boolean — Indicates whether supplier data should be duplicated.
      - `keepItemNumber` boolean — Indicates whether the supplier-specific item SKU (article number) should be kept during duplication. When true, the SKU used by the supplier will be duplicated.
      - `keepItemName` boolean — Indicates whether the supplier-specific item name should be kept during duplication. When true, the item name used by the supplier will be duplicated.
    - `saleschannelDuplicationOptions` JTLWawiItemPublicApiDataTransferObjectsV2DuplicateItemCreateSaleschannelDuplicationOptions — Options for duplicating saleschannel settings.
      - `isActive` boolean — Indicates whether saleschannel settings should be duplicated.
      - `considerHighlightOptions` boolean — Indicates whether item highlight options should be considered during duplication. When true, special highlighting and promotional settings for sales channels will be duplicated.
    - `scxDuplicationOptions` JTLWawiItemPublicApiDataTransferObjectsV2DuplicateItemCreateScxDuplicationOptions — Options for duplicating SCX data.
      - `isActive` boolean — Indicates whether SCX data should be duplicated.
      - `considerCategoryMappings` boolean — Indicates whether assigned categories should be considered during duplication. When true, category assignments for sales channels will be duplicated.
      - `considerSalesChannelFieldValues` boolean — Indicates whether custom field values should be considered during duplication. When true, sales channel-specific custom field values will be duplicated.
      - `considerEveryShop` boolean — Indicates whether all shops should be considered during duplication. When true, SCX data will be duplicated for all configured sales channels.
      - `shopsToConsider` JTLDataContractsKeysShopKey[] — List of sales channel keys for which the SCX data should be duplicated. Only data for the specified sales channels will be copied to the new item.
    - `packagingDuplicationOptions` JTLWawiItemPublicApiDataTransferObjectsV2DuplicateItemCreatePackagingDuplicationOptions — Options for copying item packaging settings.
      - `isActive` boolean — Indicates whether packaging settings should be duplicated.

## Response `200`

Items successfully duplicated

---

[API](https://skmtc.net/jtl-software/apis/scx-authentication-api.md) · [All operations](https://skmtc.net/jtl-software/apis/scx-authentication-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/jtl-software/scx-authentication-api/revisions/f979b1ea6951/schema)
