# Creation of parametric category

Creates a new combination for a parametric category.

A parametric category for the selected parameter codes and the default category must exist.
You can create only one parametric category combination for each combination of parameterCode and valueCode.

The "Advanced SEO" module must be active to use this endpoint.

Endpoint: POST /api/parametric-categories
Version: 1.0.0
Security: shoptetAccessToken, shoptetPrivateApiToken

## Query parameters:

  - `include` (string)
    Include additional data in response. Possible values: .
    Example: "parameters"

## Header parameters:

  - `Content-Type` (string, required)

## Request fields (application/json):

  - `data` (object, required)

  - `data.name` (string, required)
    Parametric category name

  - `data.originalCategoryGuid` (string, required)
    Unique identifier of the original category from which the parametric category is created

  - `data.parameters` (array, required)
    Parameters of the parametric category

  - `data.parameters.parameterCode` (string, required)
    Code of the parameter

  - `data.parameters.valueCode` (string, required)
    Code of the parameter value

  - `data.indexName` (string)
    Last part of url. Optional, generated from  if not set.

  - `data.description` (string,null)
    Top parametric category description. Max length 65535 bytes. Optional.

  - `data.secondDescription` (string,null)
    Bottom parametric category description. Max length 65535 bytes. Optional.

  - `data.sourceImageName` (string,null)
    Name of file in [Files upload](#section/basic-principles/files-upload) storage to be set as parametric category image.

  - `data.title` (string,null)
    Meta tag title. Optional.

  - `data.metaTagDescription` (string,null)
    Meta tag description. Optional.

  - `data.showInList` (boolean,null)
    Flag, whether the parametric category is visible in category list. Default is . Optional

  - `data.showInDetail` (boolean,null)
    Flag, whether the parametric category is visible in product detail. Default is . Optional

## Response 201 fields (application/json):

  - `data` (object, required)

  - `data.parametricCategory` (object, required)

  - `data.parametricCategory.guid` (string, required)
    unique identifier of the category

  - `data.parametricCategory.name` (string, required)
    category name

  - `data.parametricCategory.indexName` (string, required)
    ending part of category URL

  - `data.parametricCategory.url` (string, required)
    category URL in the e-shop

  - `data.parametricCategory.description` (string,null, required)
    top category description

  - `data.parametricCategory.secondDescription` (string,null, required)
    bottom category description

  - `data.parametricCategory.image` (string,null, required)
    header image

  - `data.parametricCategory.title` (string,null, required)
    HTML title element in the HTML header of the category page

  - `data.parametricCategory.metaTagDescription` (string,null, required)
    HTML META header  in category page

  - `data.parametricCategory.originalCategoryGuid` (string,null, required)
    unique identifier of the original category (from which was the parametric category created)

  - `data.parametricCategory.showInList` (boolean, required)
    flag, whether the category is visible in product list

  - `data.parametricCategory.showInDetail` (boolean, required)
    flag, whether the category is visible in product detail

  - `data.parametricCategory.parameters` (array)
    parameters of the parametric category (requires  include in the request url)

  - `data.parametricCategory.parameters.parameterCode` (string, required)
    Code of the parameter

  - `data.parametricCategory.parameters.parameterName` (string, required)
    Name of the parameter

  - `data.parametricCategory.parameters.valueCode` (string, required)
    Code of the parameter value

  - `data.parametricCategory.parameters.valueName` (string, required)
    Name of the parameter value

  - `errors` (array,null, required)

  - `errors.errorCode` (string, required)
    Short text error identification

  - `errors.message` (string, required)
    Descriptive error message

  - `errors.instance` (string, required)
    Identification of the entity referenced

## Response 403 fields (application/json):

  - `data` (object,null)

  - `errors` (array,null)

  - `errors.errorCode` (string, required)
    Short text error identification

  - `errors.message` (string, required)
    Descriptive error message

  - `errors.instance` (string, required)
    Identification of the entity referenced

## Response 422 fields (application/json):

  - `data` (object,null)

  - `errors` (array,null)

  - `errors.errorCode` (string, required)
    Short text error identification

  - `errors.message` (string, required)
    Descriptive error message

  - `errors.instance` (string, required)
    Identification of the entity referenced