[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"docs-userfields\u002Fsmart-processes\u002Fcreate":3,"docs-tabs-userfields\u002Fsmart-processes\u002Fcreate":6},{"content":4,"lastmod":5},"\n## Создать поле\n\n`POST \u002Fv1\u002Fitems\u002F:entityTypeId\u002Fuserfields`\n\nСоздаёт новое пользовательское поле для элементов смарт-процесса. Возвращает HTTP `201 Created` с `id` нового поля. Поля передаются плоско в корне JSON — без обёртки `fields`.\n\n## Параметры\n\n| Параметр | Тип | Обяз. | Описание |\n|----------|-----|:-----:|---------|\n| `:entityTypeId` (path) | number | да | Идентификатор типа смарт-процесса. Источник: [`GET \u002Fv1\u002Fsmart-processes`](\u002Fdocs\u002Fentities\u002Fsmart-processes) — поле `entityTypeId` в каждом элементе массива `data` |\n\n## Поля запроса (body)\n\n| Поле | Тип | Обяз. | Описание |\n|------|-----|:-----:|---------|\n| `userTypeId` | string | да | Тип поля. Список допустимых значений — [`GET \u002Fv1\u002Fitems\u002F:entityTypeId\u002Fuserfields\u002Ftypes`](\u002Fdocs\u002Fuserfields\u002Fsmart-processes\u002Ftypes). Примеры: `string`, `enumeration`, `integer`, `double`, `datetime` |\n| `fieldName` | string | да | Полное системное имя в формате `UF_CRM_\u003CtypeId>_\u003Cсуффикс>`. Здесь `typeId` — это поле `id` (внутренний ID типа) из ответа [`GET \u002Fv1\u002Fsmart-processes`](\u002Fdocs\u002Fentities\u002Fsmart-processes\u002Flist), а не `entityTypeId` из пути запроса: значения различаются. Поле `id` доступно всегда, даже если у смарт-процесса ещё нет полей. Авто-генерация не поддерживается: бэкенд не достраивает префикс, неполное имя даёт `422 BITRIX_ERROR` |\n| `label` | string | нет | Подпись поля для отображения. Если не заданы явные `editFormLabel` \u002F `listColumnLabel`, значение копируется в обе подписи — формы редактирования (`editFormLabel`) и заголовка столбца списка (`listColumnLabel`). Для подписей по конкретным языкам используйте объекты `editFormLabel` \u002F `listColumnLabel` |\n| `editFormLabel` | object | нет | Подпись в форме редактирования по языкам. Пример: `{ \"ru\": \"Проект\", \"en\": \"Project\" }`. Значения устанавливаются для указанных языков. Остальные локали заполняются по правилам Битрикс24 |\n| `sort` | string | нет | Порядок сортировки в интерфейсе Битрикс24. По умолчанию `\"100\"` |\n| `multiple` | string | нет | Разрешить несколько значений: `\"Y\"` или `\"N\"`. По умолчанию `\"N\"` |\n| `mandatory` | string | нет | Обязательное при заполнении: `\"Y\"` или `\"N\"`. По умолчанию `\"N\"` |\n| `showFilter` | string | нет | Отображать в фильтре: `\"N\"` — нет, `\"I\"` — точное значение, `\"E\"` — маска, `\"S\"` — диапазон |\n| `showInList` | string | нет | Показывать в списке записей: `\"Y\"` или `\"N\"` |\n| `editInList` | string | нет | Разрешить редактирование прямо из списка: `\"Y\"` или `\"N\"` |\n| `isSearchable` | string | нет | Участвует в полнотекстовом поиске: `\"Y\"` или `\"N\"` |\n| `xmlId` | string | нет | Внешний идентификатор для интеграций |\n| `settings` | object | нет | Настройки поля, специфичные для `userTypeId`. Для `string` — `SIZE`, `ROWS`, `REGEXP`, `MIN_LENGTH`, `MAX_LENGTH`, `DEFAULT_VALUE`. Состав зависит от типа |\n| `enum` | array | нет | Варианты для поля типа `enumeration`. Каждый элемент: `{ \"value\": \"Название\", \"sort\": 10 }` (опционально `\"def\": \"Y\"` — значение по умолчанию). Тот же массив принимается и под ключом `list` — формат элемента одинаковый. При чтении поля варианты возвращаются в блоке `enum` |\n\n## Примеры\n\n### curl — личный ключ\n\n```bash\ncurl -X POST \"https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fitems\u002F174\u002Fuserfields\" \\\n  -H \"X-Api-Key: YOUR_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"userTypeId\": \"enumeration\",\n    \"fieldName\": \"UF_CRM_3_PROJECT_STATUS\",\n    \"label\": \"Статус проекта\",\n    \"sort\": \"200\",\n    \"showFilter\": \"I\",\n    \"showInList\": \"Y\",\n    \"enum\": [\n      { \"value\": \"Новый\", \"sort\": 10 },\n      { \"value\": \"В работе\", \"sort\": 20 },\n      { \"value\": \"Завершён\", \"sort\": 30 }\n    ]\n  }'\n```\n\n### curl — OAuth-приложение\n\n```bash\ncurl -X POST \"https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fitems\u002F174\u002Fuserfields\" \\\n  -H \"X-Api-Key: YOUR_APP_KEY\" \\\n  -H \"Authorization: Bearer USER_SESSION_TOKEN\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"userTypeId\": \"enumeration\",\n    \"fieldName\": \"UF_CRM_3_PROJECT_STATUS\",\n    \"label\": \"Статус проекта\",\n    \"sort\": \"200\",\n    \"showFilter\": \"I\",\n    \"showInList\": \"Y\",\n    \"enum\": [\n      { \"value\": \"Новый\", \"sort\": 10 },\n      { \"value\": \"В работе\", \"sort\": 20 },\n      { \"value\": \"Завершён\", \"sort\": 30 }\n    ]\n  }'\n```\n\n### JavaScript — личный ключ\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fitems\u002F174\u002Fuserfields', {\n  method: 'POST',\n  headers: {\n    'X-Api-Key': 'YOUR_API_KEY',\n    'Content-Type': 'application\u002Fjson',\n  },\n  body: JSON.stringify({\n    userTypeId: 'enumeration',\n    fieldName: 'UF_CRM_3_PROJECT_STATUS',\n    label: 'Статус проекта',\n    sort: '200',\n    showFilter: 'I',\n    showInList: 'Y',\n    enum: [\n      { value: 'Новый', sort: 10 },\n      { value: 'В работе', sort: 20 },\n      { value: 'Завершён', sort: 30 },\n    ],\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\u002Fitems\u002F174\u002Fuserfields', {\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    userTypeId: 'enumeration',\n    fieldName: 'UF_CRM_3_PROJECT_STATUS',\n    label: 'Статус проекта',\n    sort: '200',\n    showFilter: 'I',\n    showInList: 'Y',\n    enum: [\n      { value: 'Новый', sort: 10 },\n      { value: 'В работе', sort: 20 },\n      { value: 'Завершён', sort: 30 },\n    ],\n  }),\n})\n\nconst { success, data } = await res.json()\n```\n\n## Поля ответа\n\n| Поле | Тип | Описание |\n|------|-----|---------|\n| `success` | boolean | Всегда `true` при успехе |\n| `data.id` | string | Идентификатор созданного поля. Возвращается строкой. При чтении через [Получить поле](\u002Fdocs\u002Fuserfields\u002Fsmart-processes\u002Fget) то же значение приходит числом |\n\n## Пример ответа\n\n```json\n{\n  \"success\": true,\n  \"data\": {\n    \"id\": \"7119\"\n  }\n}\n```\n\n## Пример ответа при ошибке\n\n422 — некорректное имя поля (не в формате `UF_CRM_\u003CtypeId>_\u003Cсуффикс>`):\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| 400 | `MISSING_FIELD` | Не передан обязательный параметр `userTypeId` |\n| 400 | `INVALID_REQUEST` | Тело запроса не является объектом |\n| 400 | `INVALID_ENTITY_TYPE_ID` | `:entityTypeId` не является положительным целым числом |\n| 403 | `BITRIX_ACCESS_DENIED` | У ключа нет скоупа `userfieldconfig` — перевыпустите ключ с этим скоупом |\n| 403 | `SCOPE_DENIED` | API-ключ не имеет скоупа `crm` |\n| 404 | `SMART_PROCESS_NOT_FOUND` | Смарт-процесс с указанным `entityTypeId` не найден на портале |\n| 422 | `BITRIX_ERROR` | Некорректный код поля — `fieldName` не в формате `UF_CRM_\u003CtypeId>_\u003Cсуффикс>` |\n| 422 | `BITRIX_ERROR` | Неизвестный `userTypeId` (не из каталога [`\u002Ftypes`](\u002Fdocs\u002Fuserfields\u002Fsmart-processes\u002Ftypes)), дублирующее имя поля или некорректные `settings` |\n| 401 | `TOKEN_MISSING` | API-ключ не имеет настроенных токенов |\n| 401 | `MISSING_API_KEY` | Отсутствует заголовок `X-Api-Key` |\n\nПолный список общих ошибок API — [Ошибки](\u002Fdocs\u002Ferrors).\n\n## Смотрите также\n\n- [Каталог типов полей](\u002Fdocs\u002Fuserfields\u002Fsmart-processes\u002Ftypes) — список допустимых `userTypeId`\n- [Получить поле](\u002Fdocs\u002Fuserfields\u002Fsmart-processes\u002Fget) — полное описание созданного поля\n- [Обновить поле](\u002Fdocs\u002Fuserfields\u002Fsmart-processes\u002Fupdate) — изменить параметры поля\n- [Удалить поле](\u002Fdocs\u002Fuserfields\u002Fsmart-processes\u002Fdelete) — удалить поле\n- [Поля смарт-процессов](\u002Fdocs\u002Fuserfields\u002Fsmart-processes) — обзор раздела\n- [Пользовательские поля](\u002Fdocs\u002Fuserfields) — обзор раздела\n","2026-07-14",{}]