---
title: "POST /main.userfieldconfig.add"
method: POST
path: "/main.userfieldconfig.add"
tags: ["main"]
---

# POST /main.userfieldconfig.add

`POST /main.userfieldconfig.add`

## Request body

- object
  - `fields` object, required
    - `entityId` string
    - `fieldName` string
    - `userTypeId` string
    - `xmlId` string
    - `sort` integer
    - `multiple` boolean
    - `mandatory` boolean
    - `showFilter` string
    - `editInList` boolean
    - `isSearchable` boolean
    - `settings` unknown
    - `editFormLabel` unknown[]
      - unknown
    - `helpMessage` unknown[]
      - unknown
    - `enum` unknown[]
      - unknown
  - `moduleId` string, required

## Response `200`

Success response

- object
  - `result` object
    - `item` BitrixMainUserfieldconfigdto
      - `id` integer
      - `entityId` string
      - `fieldName` string
      - `userTypeId` string
      - `xmlId` string
      - `sort` integer
      - `multiple` boolean
      - `mandatory` boolean
      - `showFilter` string
      - `showInList` boolean
      - `editInList` boolean
      - `isSearchable` boolean
      - `settings` unknown
      - `editFormLabel` unknown[]
        - unknown
      - `listColumnLabel` unknown[]
        - unknown
      - `listFilterLabel` unknown[]
        - unknown
      - `errorMessage` unknown[]
        - unknown
      - `helpMessage` unknown[]
        - unknown
      - `enum` unknown[]
        - unknown

## Changes

- **2026-09-29** `f6be0a558c33` — 1 info
  - endpoint added
- **2026-09-28** `613c7e37ce51` — 1 breaking
  - api path removed without deprecation
- **2026-09-07** `604209646dc5` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/bitrix24/apis/bitrix24-rest-v3-api/changes/main.userfieldconfig.add/post.md)

---

[API](https://skmtc.dev/bitrix24/apis/bitrix24-rest-v3-api.md) · [All operations](https://skmtc.dev/bitrix24/apis/bitrix24-rest-v3-api/llms.txt) · [OpenAPI document](https://skmtc.dev/bitrix24/apis/bitrix24-rest-v3-api/revisions/f6be0a558c33?raw)
