# Import Requests Import Requests represent how you send resources to the Import API. To import [resources](https://docs.commercetools.com/api/import-export/import-resources.md) into your Project, include them in the `resources` field of an [ImportRequest](https://docs.commercetools.com/api/import-export/import-requests.md#importrequest), and [create an Import Request](https://docs.commercetools.com/api/import-export/import-requests.md#create-import-request). The system then creates one [ImportOperation](https://docs.commercetools.com/api/import-export/import-operation.md#importoperation) per resource in the ImportRequest, and returns the initial status of the import to you in an [ImportResponse](https://docs.commercetools.com/api/import-export/import-requests.md#importresponse). Import Requests are resource-specific and can contain up to 20 resources. After making the request, you can [monitor the import process](https://docs.commercetools.com/api/import-export/overview.md#monitor-the-import-process). Multiple requests can be sent to the same ImportContainer at the same time. To achieve the best performance with the Import API, we recommend having fewer than 200000 ImportOperations per ImportContainer. ## Representations ### ImportRequest #### BusinessUnitImportRequest See API type definition [BusinessUnitImportRequest](https://docs.commercetools.com/api/import-export/import-requests.md?urn=ctp%3Aimport%3Atype%3ABusinessUnitImportRequest). #### CategoryImportRequest See API type definition [CategoryImportRequest](https://docs.commercetools.com/api/import-export/import-requests.md?urn=ctp%3Aimport%3Atype%3ACategoryImportRequest). #### CustomerImportRequest See API type definition [CustomerImportRequest](https://docs.commercetools.com/api/import-export/import-requests.md?urn=ctp%3Aimport%3Atype%3ACustomerImportRequest). #### DiscountCodeImportRequest See API type definition [DiscountCodeImportRequest](https://docs.commercetools.com/api/import-export/import-requests.md?urn=ctp%3Aimport%3Atype%3ADiscountCodeImportRequest). #### EmbeddedPriceImportRequest See API type definition [PriceImportRequest](https://docs.commercetools.com/api/import-export/import-requests.md?urn=ctp%3Aimport%3Atype%3APriceImportRequest). #### InventoryImportRequest See API type definition [InventoryImportRequest](https://docs.commercetools.com/api/import-export/import-requests.md?urn=ctp%3Aimport%3Atype%3AInventoryImportRequest). #### StandalonePriceImportRequest See API type definition [StandalonePriceImportRequest](https://docs.commercetools.com/api/import-export/import-requests.md?urn=ctp%3Aimport%3Atype%3AStandalonePriceImportRequest). #### OrderImportRequest See API type definition [OrderImportRequest](https://docs.commercetools.com/api/import-export/import-requests.md?urn=ctp%3Aimport%3Atype%3AOrderImportRequest). #### OrderPatchImportRequest See API type definition [OrderPatchImportRequest](https://docs.commercetools.com/api/import-export/import-requests.md?urn=ctp%3Aimport%3Atype%3AOrderPatchImportRequest). #### ProductTypeImportRequest See API type definition [ProductTypeImportRequest](https://docs.commercetools.com/api/import-export/import-requests.md?urn=ctp%3Aimport%3Atype%3AProductTypeImportRequest). #### ProductImportRequest See API type definition [ProductImportRequest](https://docs.commercetools.com/api/import-export/import-requests.md?urn=ctp%3Aimport%3Atype%3AProductImportRequest). #### ProductDraftImportRequest See API type definition [ProductDraftImportRequest](https://docs.commercetools.com/api/import-export/import-requests.md?urn=ctp%3Aimport%3Atype%3AProductDraftImportRequest). #### ProductVariantImportRequest See API type definition [ProductVariantImportRequest](https://docs.commercetools.com/api/import-export/import-requests.md?urn=ctp%3Aimport%3Atype%3AProductVariantImportRequest). #### ProductVariantPatchRequest See API type definition [ProductVariantPatchRequest](https://docs.commercetools.com/api/import-export/import-requests.md?urn=ctp%3Aimport%3Atype%3AProductVariantPatchRequest). #### VariantImportRequest See API type definition [VariantImportRequest](https://docs.commercetools.com/api/import-export/import-requests.md?urn=ctp%3Aimport%3Atype%3AVariantImportRequest). #### ProductSelectionImportRequest See API type definition [ProductSelectionImportRequest](https://docs.commercetools.com/api/import-export/import-requests.md?urn=ctp%3Aimport%3Atype%3AProductSelectionImportRequest). #### ProductTailoringImportRequest See API type definition [ProductTailoringImportRequest](https://docs.commercetools.com/api/import-export/import-requests.md?urn=ctp%3Aimport%3Atype%3AProductTailoringImportRequest). #### TypeImportRequest See API type definition [TypeImportRequest](https://docs.commercetools.com/api/import-export/import-requests.md?urn=ctp%3Aimport%3Atype%3ATypeImportRequest). ### ImportResponse See API type definition [ImportResponse](https://docs.commercetools.com/api/import-export/import-requests.md?urn=ctp%3Aimport%3Atype%3AImportResponse). ## Create Import Request ### for Business Units See API endpoint definition [POST /\{projectKey}/business-units/import-containers/\{importContainerKey}](https://docs.commercetools.com/api/import-export/import-requests.md?urn=ctp%3Aimport%3Aendpoint%3A%2F%7BprojectKey%7D%2Fbusiness-units%2Fimport-containers%2F%7BimportContainerKey%7D%3APOST). ### for Categories See API endpoint definition [POST /\{projectKey}/categories/import-containers/\{importContainerKey}](https://docs.commercetools.com/api/import-export/import-requests.md?urn=ctp%3Aimport%3Aendpoint%3A%2F%7BprojectKey%7D%2Fcategories%2Fimport-containers%2F%7BimportContainerKey%7D%3APOST). ### for Customers See API endpoint definition [POST /\{projectKey}/customers/import-containers/\{importContainerKey}](https://docs.commercetools.com/api/import-export/import-requests.md?urn=ctp%3Aimport%3Aendpoint%3A%2F%7BprojectKey%7D%2Fcustomers%2Fimport-containers%2F%7BimportContainerKey%7D%3APOST). ### for Discount Codes See API endpoint definition [POST /\{projectKey}/discount-codes/import-containers/\{importContainerKey}](https://docs.commercetools.com/api/import-export/import-requests.md?urn=ctp%3Aimport%3Aendpoint%3A%2F%7BprojectKey%7D%2Fdiscount-codes%2Fimport-containers%2F%7BimportContainerKey%7D%3APOST). ### for Embedded Prices To create and update [Standalone Prices](https://docs.commercetools.com/api/projects/standalone-prices.md#standaloneprice), use the [Standalone Prices endpoint](https://docs.commercetools.com/api/import-export/import-requests.md#for-standalone-prices) instead. See API endpoint definition [POST /\{projectKey}/prices/import-containers/\{importContainerKey}](https://docs.commercetools.com/api/import-export/import-requests.md?urn=ctp%3Aimport%3Aendpoint%3A%2F%7BprojectKey%7D%2Fprices%2Fimport-containers%2F%7BimportContainerKey%7D%3APOST). ### for Inventory Use this endpoint to import inventory data to create and update [InventoryEntry](https://docs.commercetools.com/urn?urn=ctp%3Aapi%3Atype%3AInventoryEntry) in a Project. See API endpoint definition [POST /\{projectKey}/inventories/import-containers/\{importContainerKey}](https://docs.commercetools.com/api/import-export/import-requests.md?urn=ctp%3Aimport%3Aendpoint%3A%2F%7BprojectKey%7D%2Finventories%2Fimport-containers%2F%7BimportContainerKey%7D%3APOST). ### for Products Use this endpoint to import Product data without Product Variant or Price information. This endpoint has a smaller payload than [for Product Drafts](https://docs.commercetools.com/api/import-export/import-requests.md#for-product-drafts) and will result in faster performance as Product Variant and Price information is not involved. See API endpoint definition [POST /\{projectKey}/products/import-containers/\{importContainerKey}](https://docs.commercetools.com/api/import-export/import-requests.md?urn=ctp%3Aimport%3Aendpoint%3A%2F%7BprojectKey%7D%2Fproducts%2Fimport-containers%2F%7BimportContainerKey%7D%3APOST). ### for Product Drafts This endpoint allows you to import Products as well as Product Variants and Embedded Prices in a single import request. While using this endpoint (instead of calling three separate endpoints for [Products](https://docs.commercetools.com/api/import-export/import-requests.md#for-products), [Product Variants](https://docs.commercetools.com/api/import-export/import-requests.md#for-product-variants), and [Embedded Prices](https://docs.commercetools.com/api/import-export/import-requests.md#for-embedded-prices)) reduces the number of API calls, this single request requires a relatively large payload. When importing a Product Draft to update an existing Product, you must include all existing values for fields. If not included, they will be removed when the Product Draft is imported. See API endpoint definition [POST /\{projectKey}/product-drafts/import-containers/\{importContainerKey}](https://docs.commercetools.com/api/import-export/import-requests.md?urn=ctp%3Aimport%3Aendpoint%3A%2F%7BprojectKey%7D%2Fproduct-drafts%2Fimport-containers%2F%7BimportContainerKey%7D%3APOST). ### for Product Types See API endpoint definition [POST /\{projectKey}/product-types/import-containers/\{importContainerKey}](https://docs.commercetools.com/api/import-export/import-requests.md?urn=ctp%3Aimport%3Aendpoint%3A%2F%7BprojectKey%7D%2Fproduct-types%2Fimport-containers%2F%7BimportContainerKey%7D%3APOST). ### for Product Variants See API endpoint definition [POST /\{projectKey}/product-variants/import-containers/\{importContainerKey}](https://docs.commercetools.com/api/import-export/import-requests.md?urn=ctp%3Aimport%3Aendpoint%3A%2F%7BprojectKey%7D%2Fproduct-variants%2Fimport-containers%2F%7BimportContainerKey%7D%3APOST). ### for Product Variant Patches The Product Variant Patch endpoint can be used to update existing Product Variants in a Project. For importing new Product Variants, use the [Product Variants endpoint](https://docs.commercetools.com/api/import-export/import-requests.md#for-product-variants). See API endpoint definition [POST /\{projectKey}/product-variant-patches/import-containers/\{importContainerKey}](https://docs.commercetools.com/api/import-export/import-requests.md?urn=ctp%3Aimport%3Aendpoint%3A%2F%7BprojectKey%7D%2Fproduct-variant-patches%2Fimport-containers%2F%7BimportContainerKey%7D%3APOST). ### for Product Selections See API endpoint definition [POST /\{projectKey}/product-selections/import-containers/\{importContainerKey}](https://docs.commercetools.com/api/import-export/import-requests.md?urn=ctp%3Aimport%3Aendpoint%3A%2F%7BprojectKey%7D%2Fproduct-selections%2Fimport-containers%2F%7BimportContainerKey%7D%3APOST). ### for Product Tailoring See API endpoint definition [POST /\{projectKey}/product-tailorings/import-containers/\{importContainerKey}](https://docs.commercetools.com/api/import-export/import-requests.md?urn=ctp%3Aimport%3Aendpoint%3A%2F%7BprojectKey%7D%2Fproduct-tailorings%2Fimport-containers%2F%7BimportContainerKey%7D%3APOST). ### for Orders Use this endpoint to bulk create [Orders](https://docs.commercetools.com/api/projects/orders.md#order) in a Project. This endpoint only supports the creation of new Orders. For updating fulfillment information on existing Orders, use the [Order Patches endpoint](https://docs.commercetools.com/api/import-export/import-requests.md#for-order-patches). POST To import a single Order, use the [Create Order by Import](https://docs.commercetools.com/urn?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Forders%2Fimport%3APOST) endpoint instead. See API endpoint definition [POST /\{projectKey}/orders/import-containers/\{importContainerKey}](https://docs.commercetools.com/api/import-export/import-requests.md?urn=ctp%3Aimport%3Aendpoint%3A%2F%7BprojectKey%7D%2Forders%2Fimport-containers%2F%7BimportContainerKey%7D%3APOST). ### for Order Patches Use this endpoint to import updates to [ReturnInfo](https://docs.commercetools.com/urn?urn=ctp%3Aapi%3Atype%3AReturnInfo), [Parcel](https://docs.commercetools.com/urn?urn=ctp%3Aapi%3Atype%3AParcel), and [Delivery](https://docs.commercetools.com/urn?urn=ctp%3Aapi%3Atype%3ADelivery) of an existing [Order](https://docs.commercetools.com/api/projects/orders.md). See API endpoint definition [POST /\{projectKey}/order-patches/import-containers/\{importContainerKey}](https://docs.commercetools.com/api/import-export/import-requests.md?urn=ctp%3Aimport%3Aendpoint%3A%2F%7BprojectKey%7D%2Forder-patches%2Fimport-containers%2F%7BimportContainerKey%7D%3APOST). ### for Standalone Prices Use this endpoint to import Standalone Price data to create and update [Standalone Prices](https://docs.commercetools.com/api/projects/standalone-prices.md#standaloneprice) in a Project. To create and update [Embedded Prices](https://docs.commercetools.com/api/pricing-and-discounts-overview.md#embedded-prices), use the [Embedded Prices endpoint](https://docs.commercetools.com/api/import-export/import-requests.md#for-embedded-prices) instead. See API endpoint definition [POST /\{projectKey}/standalone-prices/import-containers/\{importContainerKey}](https://docs.commercetools.com/api/import-export/import-requests.md?urn=ctp%3Aimport%3Aendpoint%3A%2F%7BprojectKey%7D%2Fstandalone-prices%2Fimport-containers%2F%7BimportContainerKey%7D%3APOST). ### for Variants Use this endpoint to import Variant data to create and update [Variants](https://docs.commercetools.com/api/projects/variants.md) in a Project. This endpoint is only available for Projects with `productCatalogModel` set to `Modular`. See API endpoint definition [POST /\{projectKey}/variants/import-containers/\{importContainerKey}](https://docs.commercetools.com/api/import-export/import-requests.md?urn=ctp%3Aimport%3Aendpoint%3A%2F%7BprojectKey%7D%2Fvariants%2Fimport-containers%2F%7BimportContainerKey%7D%3APOST). ### for Types See API endpoint definition [POST /\{projectKey}/types/import-containers/\{importContainerKey}](https://docs.commercetools.com/api/import-export/import-requests.md?urn=ctp%3Aimport%3Aendpoint%3A%2F%7BprojectKey%7D%2Ftypes%2Fimport-containers%2F%7BimportContainerKey%7D%3APOST). ## Related pages - [Section overview page](https://docs.commercetools.com/api.md) - [Previous page: Import Containers](https://docs.commercetools.com/api/import-export/import-container.md) - [Next page: Import Resources](https://docs.commercetools.com/api/import-export/import-resources.md)