---
title: "POST /{projectKey}/business-units/import-containers/{importContainerKey}"
method: POST
path: "/{projectKey}/business-units/import-containers/{importContainerKey}"
---

# POST /{projectKey}/business-units/import-containers/{importContainerKey}

`POST /{projectKey}/business-units/import-containers/{importContainerKey}`

## Request

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

Creates an Import Request for Business Units.

## Request body

- BusinessUnitImportRequest
  - `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
  - `resources` BusinessUnitImport[], required
    - `unitType` 'Company' | 'Division', required
    - `key` string, required
    - `name` string, required
    - `status` 'Active' | 'Inactive'
    - `contactEmail` string
    - `associates` AssociateDraft[]
      - `customer` CustomerKeyReference, required
        - `key` string, required
        - `typeId` 'associate-role' | 'business-unit' | 'cart' | 'cart-discount' | 'category' | 'channel' | 'customer' | 'customer-group' | 'discount-code' | 'key-value-document' | 'order' | 'payment' | 'price' | 'product' | 'product-discount' | 'product-type' | 'product-variant' | 'variant' | 'shipping-method' | 'state' | 'store' | 'tax-category' | 'type', required
      - `associateRoleAssignments` AssociateRoleAssignmentDraft[], required
        - `associateRole` AssociateRoleKeyReference, required
          - `key` string, required
          - `typeId` 'associate-role' | 'business-unit' | 'cart' | 'cart-discount' | 'category' | 'channel' | 'customer' | 'customer-group' | 'discount-code' | 'key-value-document' | 'order' | 'payment' | 'price' | 'product' | 'product-discount' | 'product-type' | 'product-variant' | 'variant' | 'shipping-method' | 'state' | 'store' | 'tax-category' | 'type', required
        - `inheritance` 'Enabled' | 'Disabled', required
    - `addresses` 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
          - `key` string, required
          - `typeId` 'associate-role' | 'business-unit' | 'cart' | 'cart-discount' | 'category' | 'channel' | 'customer' | 'customer-group' | 'discount-code' | 'key-value-document' | 'order' | 'payment' | 'price' | 'product' | 'product-discount' | 'product-type' | 'product-variant' | 'variant' | 'shipping-method' | 'state' | 'store' | 'tax-category' | 'type', required
        - `fields` FieldContainer
    - `shippingAddresses` integer[]
    - `defaultShippingAddress` integer
    - `billingAddresses` integer[]
    - `defaultBillingAddress` integer
    - `stores` StoreKeyReference[]
      - `key` string, required
      - `typeId` 'associate-role' | 'business-unit' | 'cart' | 'cart-discount' | 'category' | 'channel' | 'customer' | 'customer-group' | 'discount-code' | 'key-value-document' | 'order' | 'payment' | 'price' | 'product' | 'product-discount' | 'product-type' | 'product-variant' | 'variant' | 'shipping-method' | 'state' | 'store' | 'tax-category' | 'type', required
    - `custom` Custom
      - `type` TypeKeyReference, required
        - `key` string, required
        - `typeId` 'associate-role' | 'business-unit' | 'cart' | 'cart-discount' | 'category' | 'channel' | 'customer' | 'customer-group' | 'discount-code' | 'key-value-document' | 'order' | 'payment' | 'price' | 'product' | 'product-discount' | 'product-type' | 'product-variant' | 'variant' | 'shipping-method' | 'state' | 'store' | 'tax-category' | 'type', required
      - `fields` FieldContainer

## 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`: 5 breaking
  - the request property `allOf[subschema #2]/resources/items/addresses/items/custom/type/allOf[subschema #2]/typeId` became required
  - the request property `allOf[subschema #2]/resources/items/associates/items/associateRoleAssignments/items/associateRole/allOf[subschema #2]/typeId` became required
  - the request property `allOf[subschema #2]/resources/items/associates/items/customer/allOf[subschema #2]/typeId` became required
  - the request property `allOf[subschema #2]/resources/items/custom/type/allOf[subschema #2]/typeId` became required
  - …1 more
- **2026-06-26** `13af4e5cda94`: 13 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]/resources/items/addresses/items/custom/type/allOf[#/components/schemas/KeyReference]/typeId`
  - added the new `variant` enum value to the request property `allOf[subschema #2]/resources/items/addresses/items/custom/type/allOf[subschema #2]/typeId`
  - …9 more
- …earlier changes not shown

[Operation history](https://skmtc.dev/commercetools/apis/import-api/changes/:projectKey/business-units/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)