Importing Product Types

Create and update ProductTypes in your Project.

The ProductType data to import is represented by ProductTypeImport and included in a ProductTypeImportRequest, which is imported using Import ProductTypes.

Read the Nested Attribute tutorial to learn how to create/update nested Attribute values with the Import API.

Representations

ProductTypeImportRequest

The request body to import ProductTypes. Contains data for ProductTypes to be created or updated in a Project.

type
String
"product-type"

The Product Type import resource type.

resources
Array of ProductTypeImport

The product type import resources of this request.

MaxItems: 20
Example: json
{
"type": "product-type",
"resources": [
{
"key": "sample",
"name": "test_product_type",
"description": "Test product type.",
"attributes": [
{
"name": "product-ref-attribute",
"label": {
"en": "selling product"
},
"isRequired": false,
"isSearchable": false,
"type": {
"name": "reference",
"referenceTypeId": "category"
},
"attributeConstraint": "Unique",
"inputTip": {
"en": "product input tip"
},
"inputHint": "SingleLine"
}
]
}
]
}

ProductTypeImport

The data representation for a ProductType to be imported that is persisted as a ProductType in the Project.

key
String

User-defined unique identifier. If a ProductType with this key exists, it will be updated with the imported data.

MinLength: 2MaxLength: 256Pattern: ^[A-Za-z0-9_-]+$
name
String

Maps to ProductType.name.

description
String

Maps to ProductType.description.

attributes
Array of AttributeDefinition

The attributes of ProductType.

Import ProductTypes

POST
https://import.{region}.commercetools.com/{projectKey}/product-types/import-containers/{importContainerKey}

Creates a request for creating new ProductTypes or updating existing ones.

OAuth 2.0 Scopes:
manage_products:{projectKey}
Path parameters:
region
String

The Region in which the Project is hosted.

projectKey
String

The Project key.

importContainerKey
String

The ImportContainer used to create the new resource

Request Body:ProductTypeImportRequestasapplication/json
Response:
201ImportResponseasapplication/json