# Создать поле

`POST /v1/userfields/tasks`

Метод Б24: `task.item.userfield.add`. Скоуп: `task`.

**Поле общее на весь портал: появится в каждой задаче у всех сотрудников.**

Обязательны `fieldName` и `userTypeId`. Необязательны `label` — строка или объект по языкам, `multiple`, `mandatory` — boolean, `sort` — целое число, `settings` — объект, `items` — массив вариантов enumeration. Б24 приводит имя к `UF_<UPPER>`. label раскладывается в три подписи, без записи в текст ошибки или подсказку. boolean с multiple:true запрещён. Обязательность REST задач не навязывает: задача без значения поля создаётся. Ответ `201 {success:true,data:{id,fieldName,...}}` содержит перечитанное поле.

Пример тела: `{"fieldName":"UF_VIBEPROBE_CLIENT","userTypeId":"enumeration","label":"Клиент","items":[{"value":"Первый","xmlId":"first"},{"value":"Второй","xmlId":"second"}]}`.

## Ошибки и доступ

Нет скоупа: `403 SCOPE_DENIED`. Без тарифной фичи TASK_CUSTOM_FIELDS: `403 TASK_CUSTOM_FIELDS_UNAVAILABLE`, включая чтение. Поле не найдено: `404 ENTITY_NOT_FOUND`. Невалидный ввод: `400`; бизнес-отказ Б24: `422`. Нет прав Б24 на запись: `403`. Чтения доступны READONLY-ключу; записи требуют READWRITE и прав администратора портала. Записи автоматически не повторяются. После таймаута исход неизвестен: перечитайте поле перед новой записью.

[Все операции полей задач](/docs/userfields/tasks)

Сортировка варианта `items.sort` должна быть положительной: Б24 игнорирует ноль. Для снятия `def:true` у одиночного списка выберите другой вариант с `def:true` в том же PATCH; иначе `400 INVALID_PARAMS`. После подтверждённой записи ошибка перечитывания даёт `502 TASK_USERFIELD_READBACK_FAILED` с `error.fieldId` и `error.writeConfirmed:true`: повторите GET, не запись.