# Create item group

Creates an item group within a project.
NoteDo not use this endpoint for building a store catalog. Use the Get item group list client-side endpoint instead.

Endpoint: POST /v2/project/{project_id}/admin/items/groups
Version: 2.0.0
Security: basicAuth

## Path parameters:

  - `project_id` (integer, required)
    Project ID. You can find this parameter in your Publisher Account next to the project name and in the browser address bar when working with a project. The URL has the following format: https://publisher.xsolla.com//projects/.
    Example: 44056

## Request fields (application/json):

  - `description` (any)

  - `external_id` (string, required)
    External ID of the item group. Can contain only alphanumeric characters, hyphens, and underscores.
    Example: "weapons"

  - `iconUrl` (string,null)
    URL of the item group image.

  - `isEnabled` (boolean)
    Whether the item group is enabled in the catalog.
    Example: true

  - `name` (any, required)

  - `order` (integer)
    Display order of the item group in the catalog. The higher the value, the lower the group appears in the list. If the values are the same, groups are sorted by creation date, with newer groups displayed higher.

## Response 201 fields (application/json):

  - `external_id` (string)
    External item group ID specified during creation.
    Example: "weapons"

## Response 401 fields (application/json):

  - `errorCode` (integer)
    오류 코드입니다.

  - `errorMessage` (string)
    Short error description.

  - `statusCode` (integer)
    HTTP response status.

  - `transactionId` (string)
    Request ID. The ID used to track and associate log entries related to this specific request or operation. This ID can be helpful for troubleshooting, debugging, and auditing purposes.

## Response 422 fields (application/json):

  - `errorCode` (integer, required)
    오류 코드입니다.
    Example: 1102

  - `errorMessage` (string, required)
    Short error description.
    Example: "[0401-1102]: Unprocessable Entity. The property `property_name` is required"

  - `errorMessageExtended` (array)
    Validation error details. Contains an array of property-level errors describing which fields failed validation and why.

  - `errorMessageExtended.message` (string)
    Validation error message for the field.
    Example: "The property external_id is required"

  - `errorMessageExtended.property` (string)
    Name of the field that failed validation.
    Example: "external_id"

  - `statusCode` (integer, required)
    HTTP response status.
    Example: 422

  - `transactionId` (string, required)
    Request ID. The ID used to track and associate log entries related to this specific request or operation. This ID can be helpful for troubleshooting, debugging, and auditing purposes.
    Example: "x-x-x-x-transactionId-mock-x-x-x"