---
title: "POST /{projectKey}/order-patches/import-containers/{importContainerKey}"
method: POST
path: "/{projectKey}/order-patches/import-containers/{importContainerKey}"
---

# POST /{projectKey}/order-patches/import-containers/{importContainerKey}

`POST /{projectKey}/order-patches/import-containers/{importContainerKey}`

## Request

- Base URL: `https://import.europe-west1.gcp.commercetools.com`
- URL: `https://import.europe-west1.gcp.commercetools.com/{projectKey}/order-patches/import-containers/{importContainerKey}`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://auth.europe-west1.gcp.commercetools.com/oauth/token` scopes: `manage_orders:{projectKey}`
- TypeScript: <https://skmtc.dev/commercetools/apis/import-api/docs/:projectKey/order-patches/import-containers/:importContainerKey/post.ts> (a function with typed inputs; its response is checked against the schema)

Creates an Import Request for updating Orders.

## Request body

- OrderPatchImportRequest
  - `type` 'business-unit' | 'category' | 'customer' | 'discount-code' | 'inventory' | 'order' | 'order-patch' | 'price' | 'product' | 'product-draft' | 'product-selection' | 'product-tailoring' | 'product-type' | 'product-variant' | 'product-variant-patch' | 'standalone-price' | 'variant' | 'type', required
  - `patches` OrderPatchImport[], required
    - `orderNumber` string, required
    - `fields` OrderField, required
      - `addReturnInfo` ReturnInfo
        - `items` ReturnItemDraft[], required
          - `quantity` number, double, required
          - `lineItemId` string
          - `customLineItemId` string
          - `comment` string
          - `shipmentState` 'Advised' | 'Returned' | 'BackInStock' | 'Unusable', required
        - `returnTrackingId` string
        - `returnDate` string, datetime
      - `addParcelToDelivery` DeliveryParcel
        - `deliveryId` string, required
        - `measurements` ParcelMeasurements
          - `heightInMillimeter` number, double
          - `lengthInMillimeter` number, double
          - `widthInMillimeter` number, double
          - `weightInGram` number, double
        - `trackingData` TrackingData
          - `trackingId` string
          - `carrier` string
          - `provider` string
          - `providerTransaction` string
          - `isReturn` boolean
        - `items` DeliveryItem[]
          - `id` string, required
          - `quantity` number, double, required
      - `addDeliveries` DeliveryDraft[]
        - `items` DeliveryItem[], required
          - `id` string, required
          - `quantity` number, double, required
        - `address` Address
          - `id` string
          - `key` string
          - `title` string
          - `salutation` string
          - `firstName` string
          - `lastName` string
          - `streetName` string
          - `streetNumber` string
          - `additionalStreetInfo` string
          - `postalCode` string
          - `city` string
          - `region` string
          - `state` string
          - `country` string, required
          - `company` string
          - `department` string
          - `building` string
          - `apartment` string
          - `pOBox` string
          - `phone` string
          - `mobile` string
          - `email` string
          - `fax` string
          - `additionalAddressInfo` string
          - `externalId` string
          - `custom` Custom
            - `type` TypeKeyReference, required
              - …
            - `fields` FieldContainer
        - `parcels` DeliveryParcelDraft[], required
          - `measurements` ParcelMeasurements
            - `heightInMillimeter` number, double
            - `lengthInMillimeter` number, double
            - `widthInMillimeter` number, double
            - `weightInGram` number, double
          - `trackingData` TrackingData
            - `trackingId` string
            - `carrier` string
            - `provider` string
            - `providerTransaction` string
            - `isReturn` boolean
          - `items` DeliveryItem[]
            - `id` string, required
            - `quantity` number, double, required
      - `removeDelivery` RemoveDeliveryDraft
        - `id` string, required
      - `removeParcelFromDelivery` RemoveParcelFromDeliveryDraft
        - `parcelId` string, required
      - `setDeliveryAddress` DeliveryAddressDraft
        - `deliveryId` string, required
        - `address` Address
          - `id` string
          - `key` string
          - `title` string
          - `salutation` string
          - `firstName` string
          - `lastName` string
          - `streetName` string
          - `streetNumber` string
          - `additionalStreetInfo` string
          - `postalCode` string
          - `city` string
          - `region` string
          - `state` string
          - `country` string, required
          - `company` string
          - `department` string
          - `building` string
          - `apartment` string
          - `pOBox` string
          - `phone` string
          - `mobile` string
          - `email` string
          - `fax` string
          - `additionalAddressInfo` string
          - `externalId` string
          - `custom` Custom
            - `type` TypeKeyReference, required
              - …
            - `fields` FieldContainer
      - `setParcelMeasurements` ParcelMeasurementDraft
        - `parcelId` string, required
        - `measurements` ParcelMeasurements
          - `heightInMillimeter` number, double
          - `lengthInMillimeter` number, double
          - `widthInMillimeter` number, double
          - `weightInGram` number, double
      - `setParcelTrackingData` ParcelTrackingData
        - `parcelId` string, required
        - `trackingData` TrackingData
          - `trackingId` string
          - `carrier` string
          - `provider` string
          - `providerTransaction` string
          - `isReturn` boolean
      - `setParcelItems` ParcelItems[]
        - `parcelId` string, required
        - `items` DeliveryItem[]
          - `id` string, required
          - `quantity` number, double, required

## Response `201`

201

- ImportResponse
  - `operationStatus` ImportOperationStatus[], required
    - `operationId` string
    - `state` 'processing' | 'validationFailed', required
    - `errors` ErrorObject[]
      - `code` string, required
      - `message` string, required

## Other responses

- `400`: The request was invalid.

## Changes

- **2026-08-20** `980be2e37843`: 2 breaking
  - the request property `allOf[subschema #2]/patches/items/fields/addDeliveries/items/address/custom/type/allOf[subschema #2]/typeId` became required
  - the request property `allOf[subschema #2]/patches/items/fields/setDeliveryAddress/address/custom/type/allOf[subschema #2]/typeId` became required
- **2026-06-26** `13af4e5cda94`: 7 info
  - added `variant` discriminator mapping keys to the `allOf[#/components/schemas/ImportRequest]/` request property
  - added the new `variant` enum value to the request property `allOf[#/components/schemas/ImportRequest]/type`
  - added the new `variant` enum value to the request property `allOf[subschema #2]/patches/items/fields/addDeliveries/items/address/custom/type/allOf[#/components/schemas/KeyReference]/typeId`
  - added the new `variant` enum value to the request property `allOf[subschema #2]/patches/items/fields/addDeliveries/items/address/custom/type/allOf[subschema #2]/typeId`
  - …3 more
- **2026-05-27** `6ad0361536a0`: 3 info
  - added `product-tailoring` discriminator mapping keys to the `allOf[#/components/schemas/ImportRequest]/` request property
  - added the new `product-tailoring` enum value to the request property `allOf[#/components/schemas/ImportRequest]/type`
  - added the new `product-tailoring` enum value to the request property `allOf[subschema #2]/type`
- …earlier changes not shown

[Operation history](https://skmtc.dev/commercetools/apis/import-api/changes/:projectKey/order-patches/import-containers/:importContainerKey/post.md)

---

[API](https://skmtc.dev/commercetools/apis/import-api.md) - [All operations](https://skmtc.dev/commercetools/apis/import-api/llms.txt) - [OpenAPI document](https://skmtc.dev/commercetools/apis/import-api/revisions/980be2e37843?raw)