# Create item group

Creates an item group within a project.
To retrieve item groups for building a catalog, use the Get item group list client-side endpoint.

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):

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

  - `name` (object,null, required)
    Object with localizations for group's name. Accepts value in one of two formats: two-letter lowercase language codes (e.g., en) or five-character locale codes (e.g., en-US). While both formats are accepted as input, responses return two-letter lowercase language codes. When both options for the same language are provided (e.g., en and en-US), the last provided value is stored. You can find the full list of supported languages in the [documentation](/doc/shop-builder/references/supported-languages/).

  - `description` (object,null)
    Object with localizations for group's description. Accepts value in one of two formats: two-letter lowercase language codes (e.g., en) or five-character locale codes (e.g., en-US). While both formats are accepted as input, responses return two-letter lowercase language codes. When both options for the same language are provided (e.g., en and en-US), the last provided value is stored. You can find the full list of supported languages in the [documentation](/doc/shop-builder/references/supported-languages/).

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

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

  - `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.
    Example: 1

## Response 201 fields (application/json):

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

## Response 401 fields (application/json):

  - `statusCode` (integer)
    HTTP response status.

  - `errorCode` (integer)
    Error code.

  - `errorMessage` (string)
    Short error description.

  - `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):

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

  - `errorCode` (integer, required)
    Error code.
    Example: 1102

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

  - `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"

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

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

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