library.category.add

Scope: library

Кто может вызывать: Модератор категорий.

HTTP: POST

Побочные эффекты: Создаёт раздел iblock.

Параметры метода

Параметр	Тип	Обяз.	Описание
`name`	`string`	да	Название
`sort`	`int`	нет	Сортировка
`color`	`string`	нет	Цвет CSS
`active`	`bool`	нет	Активность. Алиасы: `isActive`

Возвращаемые данные

Объект категории в result.result (list — массив + total, next):

Поле	Тип	Описание
`id`	`int`	ID раздела
`name`	`string`	Название
`active`	`bool`	Активна
`sort`	`int`	Сортировка
`color`	`string`	Цвет (CSS)
`booksCount`	`int`	Число книг в разделе
`createdBy`	`int`	Создатель
`dateCreate`	`string`	Дата создания
`modifiedBy`	`int`	Кто изменил
`dateModify`	`string`	Дата изменения

Обработка ошибок

Справочник кодов: error-codes.md.

Код	Описание
`PERMISSION_DENIED`	Нет прав модератора категорий

Пример запроса (POST)

curl -X POST "https://76590.dev.wehive.digital/rest/1/{webhook_code}/library.category.add.json"
          -H "Content-Type: application/json"
          -H "Accept: application/json"
          --data '{
          "name": "REST docs cat 20260827-105030",
          "sort": 400,
          "color": "#336699",
          "active": true
        }'

Пример ответа

{
          "result": {
            "result": {
              "id": 141,
              "name": "REST docs cat 20260827-105030",
              "active": true,
              "sort": 400,
              "color": "#336699",
              "booksCount": 0,
              "createdBy": 1,
              "dateCreate": "27.08.2026 10:50:32",
              "modifiedBy": 1,
              "dateModify": "27.08.2026 10:50:32"
            },
            "error": null
          }
        }