[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"docs-entities\u002Fproduct-sections\u002Fcreate":3,"docs-tabs-entities\u002Fproduct-sections\u002Fcreate":6},{"content":4,"lastmod":5},"\n## Создать раздел\n\n`POST \u002Fv1\u002Fproduct-sections`\n\nСоздаёт новый раздел в каталоге товаров. Поля передаются плоско в корне JSON, без обёртки `fields`.\n\n## Поля запроса (body)\n\n| Поле | Битрикс24 | Тип | Обяз. | Описание |\n|------|----------|-----|:-----:|---------|\n| `name` | `NAME` | string | да | Название раздела |\n| `catalogId` | `CATALOG_ID` | number | нет | Идентификатор каталога. Если не передавать — используется каталог товаров CRM портала. Список: `GET \u002Fv1\u002Fcatalogs` |\n| `sectionId` | `SECTION_ID` | number | нет | Идентификатор родительского раздела для вложенности. У раздела верхнего уровня — `null` |\n| `code` | `CODE` | string | нет | Символьный код раздела. Если не передавать — формируется из `name` |\n| `xmlId` | `XML_ID` | string | нет | Внешний идентификатор |\n| `sort` | `SORT` | number | нет | Индекс сортировки |\n\n## Примеры\n\n### curl — личный ключ\n\n```bash\ncurl -X POST \"https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fproduct-sections\" \\\n  -H \"X-Api-Key: YOUR_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"name\": \"Одежда\",\n    \"catalogId\": 25\n  }'\n```\n\n### curl — OAuth-приложение\n\n```bash\ncurl -X POST \"https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fproduct-sections\" \\\n  -H \"X-Api-Key: YOUR_APP_KEY\" \\\n  -H \"Authorization: Bearer USER_SESSION_TOKEN\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"name\": \"Одежда\",\n    \"catalogId\": 25\n  }'\n```\n\n### JavaScript — личный ключ\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fproduct-sections', {\n  method: 'POST',\n  headers: {\n    'X-Api-Key': 'YOUR_API_KEY',\n    'Content-Type': 'application\u002Fjson',\n  },\n  body: JSON.stringify({\n    name: 'Одежда',\n    catalogId: 25,\n  }),\n})\n\nconst { success, data } = await res.json()\nconsole.log('ID раздела:', data.id)\n```\n\n### JavaScript — OAuth-приложение\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fproduct-sections', {\n  method: 'POST',\n  headers: {\n    'X-Api-Key': 'YOUR_APP_KEY',\n    'Authorization': 'Bearer USER_SESSION_TOKEN',\n    'Content-Type': 'application\u002Fjson',\n  },\n  body: JSON.stringify({\n    name: 'Одежда',\n    catalogId: 25,\n  }),\n})\n\nconst { success, data } = await res.json()\n```\n\n## Поля ответа\n\nВозвращается полный объект созданного раздела.\n\n| Поле | Тип | Описание |\n|------|-----|---------|\n| `id` | number | Идентификатор созданного раздела |\n| `name` | string | Название раздела |\n| `catalogId` | number | Идентификатор каталога |\n| `sectionId` | number | Идентификатор родительского раздела или `null` |\n| `xmlId` | string | Внешний идентификатор или `null` |\n| `code` | string | Символьный код раздела |\n\n## Пример ответа\n\n```json\n{\n  \"success\": true,\n  \"data\": {\n    \"id\": 197,\n    \"name\": \"Одежда\",\n    \"catalogId\": 25,\n    \"sectionId\": null,\n    \"xmlId\": null,\n    \"code\": \"odezhda\"\n  }\n}\n```\n\n## Пример ответа при ошибке\n\n422 — не передано название раздела:\n\n```json\n{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"BITRIX_ERROR\",\n    \"message\": \"Не указано название раздела.\"\n  }\n}\n```\n\n## Ошибки\n\n| HTTP | Код | Описание |\n|------|-----|----------|\n| 422 | `BITRIX_ERROR` | Не передано поле `name` — сообщение «Не указано название раздела.» |\n| 400 | `READONLY_FIELD` | В теле передано поле, доступное только для чтения, — `id` |\n| 403 | `SCOPE_DENIED` | Ключу не хватает скоупа `crm` |\n| 401 | `MISSING_API_KEY` | Не передан заголовок `X-Api-Key` |\n\nПолный список общих ошибок API — [Ошибки](\u002Fdocs\u002Ferrors).\n\n## Смотрите также\n\n- [Список разделов](\u002Fdocs\u002Fentities\u002Fproduct-sections\u002Flist)\n- [Обновить раздел](\u002Fdocs\u002Fentities\u002Fproduct-sections\u002Fupdate)\n- [Удалить раздел](\u002Fdocs\u002Fentities\u002Fproduct-sections\u002Fdelete)\n- [Каталоги](\u002Fdocs\u002Fentities\u002Fcatalogs)\n- [Batch](\u002Fdocs\u002Fbatch)\n","2026-06-19",{}]