---
updatedAt: 2025-11-23T08:56:03.000Z
agentTools:
  projectIndex: https://rivhit-api.readme.io/llms.txt
---

# ItemGroup.New

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "title": "Add an Item Group",
    "version": "1.0.0"
  },
  "paths": {
    "/online/RivhitOnlineAPI.svc/ItemGroup.New": {
      "post": {
        "summary": "ItemGroup.New",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "api_token": {
                    "type": "string",
                    "format": "uuid",
                    "example": "DECD03E5-E35C-41E8-84F7-FBA2FB483928",
                    "description": "Rivhit Merchant API Identifier.\n\n**Default:** No\n",
                    "nullable": false,
                    "deprecated": false
                  },
                  "item_group_name": {
                    "type": "string",
                    "example": "New Group Name",
                    "description": "Item Group Name.\n\n**Max Length:** 100 Characters\n**Default:** No\n",
                    "nullable": false,
                    "deprecated": false
                  },
                  "request_reference": {
                    "type": "string",
                    "example": "abcdefg-&123456789",
                    "description": "The Item creation Request Reference.\n\n~ Use for future search with method - Status.LastRequest\n~ Should be unique value\n**Length:** 2GB\n**Default:** No\n",
                    "nullable": true,
                    "deprecated": false
                  }
                },
                "required": [
                  "api_token",
                  "item_group_name"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Success - Item Group Created",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error_code": {
                      "type": "integer",
                      "example": 0,
                      "description": "The Response Error/Status Number (0 = Success)."
                    },
                    "client_message": {
                      "type": "string",
                      "example": "",
                      "description": "The Client Error Message."
                    },
                    "debug_message": {
                      "type": "string",
                      "example": "",
                      "description": "The Response Error Message."
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "item_group_id": {
                          "type": "integer",
                          "description": "The New Item Group Id."
                        }
                      }
                    }
                  }
                },
                "example": {
                  "error_code": 0,
                  "client_message": "",
                  "debug_message": "",
                  "data": {
                    "item_group_id": 15
                  }
                }
              }
            }
          },
          "400": {
            "description": "Request Error",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string",
                      "example": "Request Error"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error_code": {
                      "type": "integer",
                      "example": 0,
                      "description": "Error code of the response."
                    },
                    "client_message": {
                      "type": "string",
                      "example": "",
                      "description": "The Client Error Message."
                    },
                    "debug_message": {
                      "type": "string",
                      "example": "",
                      "description": "The Response Error Message."
                    },
                    "data": {
                      "type": "array",
                      "example": null
                    }
                  }
                },
                "example": {
                  "error_code": 500,
                  "client_message": "ארעה שגיאה, אנא פנה למנהל המערכת",
                  "debug_message": "String or binary data would be truncated.\r\nThe statement has been terminated.",
                  "data": null
                }
              }
            }
          }
        }
      }
    }
  },
  "servers": [
    {
      "url": "https://api.rivhit.co.il/"
    }
  ]
}
```