Создать пользовательское поле для лидов crm.lead.userfield.add

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"fields":{"LABEL":"Поле Привет, мир!","USER_TYPE_ID":"string","FIELD_NAME":"HELLO_WORLD","MULTIPLE":"Y","MANDATORY":"Y","SHOW_FILTER":"Y","SETTINGS":{"DEFAULT_VALUE":"Привет, мир! Значение по умолчанию","ROWS":3},"SORT":1000,"EDIT_IN_LIST":"Y","LIST_FILTER_LABEL":"Привет, мир! Фильтр","LIST_COLUMN_LABEL":{"en":"Hello, World! Column","ru":"Привет, мир! Колонка","de":"Hallo, Welt! Spalte"},"EDIT_FORM_LABEL":{"en":"Hello, World! Edit","ru":"Привет, мир! Редактировать","de":"Hallo, Welt! Bearbeiten"},"ERROR_MESSAGE":{"en":"Hello, World! Error","ru":"Привет, мир! Ошибка","de":"Hallo, Welt! Fehler"},"HELP_MESSAGE":{"en":"Hello, World! Help","ru":"Привет, мир! Помощь","de":"Hallo, Welt! Hilfe"}},"auth":"**put_access_token_here**"}' \
https://**put_your_bitrix24_address**/rest/crm.lead.userfield.add

// This snippet is an ES module: top-level await requires type="module" or a bundler.
// $b24 is an already-initialized SDK instance (see the SDK "Get started" guide).
import { Text } from '@bitrix24/b24jssdk'
import type { B24Frame } from '@bitrix24/b24jssdk'

declare const $b24: B24Frame

try {
  const response = await $b24.actions.v2.call.make<number>({
    method: 'crm.lead.userfield.add',
    params: {
      fields: {
        LABEL: 'Hello World field',
        USER_TYPE_ID: 'string',
        FIELD_NAME: 'HELLO_WORLD',
        MULTIPLE: 'Y',
        MANDATORY: 'Y',
        SHOW_FILTER: 'Y',
        SETTINGS: {
          DEFAULT_VALUE: 'Hello, World! Default value',
          ROWS: 3,
        },
        SORT: 1000,
        EDIT_IN_LIST: 'Y',
        LIST_FILTER_LABEL: 'Hello, World! Filter',
        LIST_COLUMN_LABEL: {
          en: 'Hello, World! Column',
          ru: 'Привет, мир! Колонка',
          de: 'Hallo, Welt! Spalte',
        },
        EDIT_FORM_LABEL: {
          en: 'Hello, World! Edit',
          ru: 'Привет, мир! Редактировать',
          de: 'Hallo, Welt! Bearbeiten',
        },
        ERROR_MESSAGE: {
          en: 'Hello, World! Error',
          ru: 'Привет, мир! Ошибка',
          de: 'Hallo, Welt! Fehler',
        },
        HELP_MESSAGE: {
          en: 'Hello, World! Help',
          ru: 'Привет, мир! Помощь',
          de: 'Hallo, Welt! Hilfe',
        },
      },
    },
    requestId: Text.getUuidRfc4122()
  })

  // The payload is available only on a successful response
  if (!response.isSuccess) {
    console.error(response.getErrorMessages().join('; '))
  } else {
    const result = response.getData()!.result
    console.info('Created user field id:', result)
  }
} catch (error) {
  // Thrown on transport or SDK failures (AjaxError, SdkError, etc.)
  console.error(error)
}

<!-- Load the SDK (UMD build); it is exposed as the global B24Js -->
<script src="https://unpkg.com/@bitrix24/b24jssdk@1/dist/umd/index.min.js"></script>
<script>
  async function addLeadUserField() {
    try {
      // Initialize the SDK inside a Bitrix24 frame
      const $b24 = await B24Js.initializeB24Frame()

      const response = await $b24.actions.v2.call.make({
        method: 'crm.lead.userfield.add',
        params: {
          fields: {
            LABEL: 'Hello World field',
            USER_TYPE_ID: 'string',
            FIELD_NAME: 'HELLO_WORLD',
            MULTIPLE: 'Y',
            MANDATORY: 'Y',
            SHOW_FILTER: 'Y',
            SETTINGS: {
              DEFAULT_VALUE: 'Hello, World! Default value',
              ROWS: 3,
            },
            SORT: 1000,
            EDIT_IN_LIST: 'Y',
            LIST_FILTER_LABEL: 'Hello, World! Filter',
            LIST_COLUMN_LABEL: {
              en: 'Hello, World! Column',
              ru: 'Привет, мир! Колонка',
              de: 'Hallo, Welt! Spalte',
            },
            EDIT_FORM_LABEL: {
              en: 'Hello, World! Edit',
              ru: 'Привет, мир! Редактировать',
              de: 'Hallo, Welt! Bearbeiten',
            },
            ERROR_MESSAGE: {
              en: 'Hello, World! Error',
              ru: 'Привет, мир! Ошибка',
              de: 'Hallo, Welt! Fehler',
            },
            HELP_MESSAGE: {
              en: 'Hello, World! Help',
              ru: 'Привет, мир! Помощь',
              de: 'Hallo, Welt! Hilfe',
            },
          },
        },
        requestId: B24Js.Text.getUuidRfc4122()
      })

      // The payload is available only on a successful response
      if (!response.isSuccess) {
        console.error(response.getErrorMessages().join('; '))
        return
      }

      const result = response.getData().result
      console.info('Created user field id:', result)
    } catch (error) {
      // Thrown on transport or SDK failures (AjaxError, SdkError, etc.)
      console.error(error)
    }
  }

  document.addEventListener('DOMContentLoaded', addLeadUserField)
</script>

from b24pysdk.errors import BitrixAPIError, BitrixSDKException

try:
    bitrix_response = client.crm.lead.userfield.add(
        fields={
            "LABEL": "Поле Привет, мир!",
            "USER_TYPE_ID": "string",
            "FIELD_NAME": "HELLO_WORLD",
            "MULTIPLE": "Y",
            "MANDATORY": "Y",
            "SHOW_FILTER": "Y",
            "SETTINGS": {
                "DEFAULT_VALUE": "Привет, мир! Значение по умолчанию",
                "ROWS": 3,
            },
            "SORT": 1000,
            "EDIT_IN_LIST": "Y",
            "LIST_FILTER_LABEL": "Привет, мир! Фильтр",
            "LIST_COLUMN_LABEL": {
                "en": "Hello, World! Column",
                "ru": "Привет, мир! Колонка",
                "de": "Hallo, Welt! Spalte",
            },
            "EDIT_FORM_LABEL": {
                "en": "Hello, World! Edit",
                "ru": "Привет, мир! Редактировать",
                "de": "Hallo, Welt! Bearbeiten",
            },
            "ERROR_MESSAGE": {
                "en": "Hello, World! Error",
                "ru": "Привет, мир! Ошибка",
                "de": "Hallo, Welt! Fehler",
            },
            "HELP_MESSAGE": {
                "en": "Hello, World! Help",
                "ru": "Привет, мир! Помощь",
                "de": "Hallo, Welt! Hilfe",
            },
        },
    ).response
    result = bitrix_response.result
    print(result)
except BitrixAPIError as error:
    print(
        "Ошибка Bitrix API",
        f"error: {error.error}",
        f"error_description: {error.error_description}",
        sep="\n",
    )
except BitrixSDKException as error:
    print(f"Ошибка Bitrix SDK: {error.message}")
except Exception as error:
    print(f"Непредвиденная ошибка: {error}")

try {
    $userfieldItemFields = [
        'FIELD_NAME' => 'HELLO_WORLD',
        'USER_TYPE_ID' => 'string',
        'SORT' => 1000,
        'MULTIPLE' => 'Y',
        'MANDATORY' => 'Y',
        'SHOW_FILTER' => 'Y',
        'EDIT_IN_LIST' => 'Y',
        'LIST_FILTER_LABEL' => 'Привет, мир! Фильтр',
        'LIST_COLUMN_LABEL' => [
            'en' => 'Hello, World! Column',
            'ru' => 'Привет, мир! Колонка',
            'de' => 'Hallo, Welt! Spalte',
        ],
        'EDIT_FORM_LABEL' => [
            'en' => 'Hello, World! Edit',
            'ru' => 'Привет, мир! Редактировать',
            'de' => 'Hallo, Welt! Bearbeiten',
        ],
        'ERROR_MESSAGE' => [
            'en' => 'Hello, World! Error',
            'ru' => 'Привет, мир! Ошибка',
            'de' => 'Hallo, Welt! Fehler',
        ],
        'HELP_MESSAGE' => [
            'en' => 'Hello, World! Help',
            'ru' => 'Привет, мир! Помощь',
            'de' => 'Hallo, Welt! Hilfe',
        ],
        'SETTINGS' => [
            'DEFAULT_VALUE' => 'Привет, мир! Значение по умолчанию',
            'ROWS' => 3,
        ],
    ];

    $result = $serviceBuilder
        ->getCRMScope()
        ->leadUserfield()
        ->add($userfieldItemFields);

    print($result->getId());
} catch (Throwable $e) {
    print('Error: ' . $e->getMessage());
}

BX24.callMethod(
    'crm.lead.userfield.add',
    {
        fields: {
            LABEL: 'Поле Привет, мир!',
            USER_TYPE_ID: 'string',
            FIELD_NAME: 'HELLO_WORLD',
            MULTIPLE: 'Y',
            MANDATORY: 'Y',
            SHOW_FILTER: 'Y',
            SETTINGS: {
                DEFAULT_VALUE: 'Привет, мир! Значение по умолчанию',
                ROWS: 3,
            },
            SORT: 1000,
            EDIT_IN_LIST: 'Y',
        },
    },
    (result) => {
        result.error()
            ? console.error(result.error())
            : console.info(result.data());
    }
);

require_once('crest.php');

$result = CRest::call(
    'crm.lead.userfield.add',
    [
        'fields' => [
            'LABEL' => 'Поле Привет, мир!',
            'USER_TYPE_ID' => 'string',
            'FIELD_NAME' => 'HELLO_WORLD',
            'MULTIPLE' => 'Y',
            'MANDATORY' => 'Y',
            'SHOW_FILTER' => 'Y',
            'SETTINGS' => [
                'DEFAULT_VALUE' => 'Привет, мир! Значение по умолчанию',
                'ROWS' => 3,
            ],
            'SORT' => 1000,
            'EDIT_IN_LIST' => 'Y',
        ]
    ]
);

echo '<PRE>';
print_r($result);
echo '</PRE>';

// client и ctx уже созданы — см. раздел «SDK для Go»
res, err := client.Core().Call(ctx, "crm.lead.userfield.add", b24.Params{
	"fields": b24.Params{
		"LABEL":        "Поле Привет, мир!",
		"USER_TYPE_ID": "string",
		"FIELD_NAME":   "HELLO_WORLD",
		"MULTIPLE":     "Y",
		"MANDATORY":    "Y",
		"SHOW_FILTER":  "Y",
		"SETTINGS": b24.Params{
			"DEFAULT_VALUE": "Привет, мир! Значение по умолчанию",
			"ROWS":          3,
		},
		"SORT":              1000,
		"EDIT_IN_LIST":      "Y",
		"LIST_FILTER_LABEL": "Привет, мир! Фильтр",
		"LIST_COLUMN_LABEL": b24.Params{
			"en": "Hello, World! Column",
			"ru": "Привет, мир! Колонка",
			"de": "Hallo, Welt! Spalte",
		},
		"EDIT_FORM_LABEL": b24.Params{
			"en": "Hello, World! Edit",
			"ru": "Привет, мир! Редактировать",
			"de": "Hallo, Welt! Bearbeiten",
		},
		"ERROR_MESSAGE": b24.Params{
			"en": "Hello, World! Error",
			"ru": "Привет, мир! Ошибка",
			"de": "Hallo, Welt! Fehler",
		},
		"HELP_MESSAGE": b24.Params{
			"en": "Hello, World! Help",
			"ru": "Привет, мир! Помощь",
			"de": "Hallo, Welt! Hilfe",
		},
	},
})
if err != nil {
	return fmt.Errorf("crm.lead.userfield.add: %w", err)
}

var newID b24.ID
if err := json.Unmarshal(res.Result, &newID); err != nil {
	return fmt.Errorf("разбор ответа: %w", err)
}
fmt.Println("идентификатор:", newID)

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"fields":{"LABEL":"Пользовательское поле (список)","USER_TYPE_ID":"enumeration","FIELD_NAME":"ENUMERATION_EXAMPLE","MULTIPLE":"N","MANDATORY":"N","SHOW_FILTER":"Y","LIST":[{"VALUE":"Элемент списка #1","DEF":"Y","XML_ID":"XML_ID_1","SORT":100},{"VALUE":"Элемент списка #2","XML_ID":"XML_ID_2","SORT":200},{"VALUE":"Элемент списка #3","XML_ID":"XML_ID_3","SORT":300},{"VALUE":"Элемент списка #4","XML_ID":"XML_ID_4","SORT":400}],"SETTINGS":{"DISPLAY":"UI","LIST_HEIGHT":2},"SORT":2000},"auth":"**put_access_token_here**"}' \
https://**put_your_bitrix24_address**/rest/crm.lead.userfield.add

// This snippet is an ES module: top-level await requires type="module" or a bundler.
// $b24 is an already-initialized SDK instance (see the SDK "Get started" guide).
import { Text } from '@bitrix24/b24jssdk'
import type { B24Frame } from '@bitrix24/b24jssdk'

declare const $b24: B24Frame

try {
  const response = await $b24.actions.v2.call.make<number>({
    method: 'crm.lead.userfield.add',
    params: {
      fields: {
        LABEL: 'Custom field (list)',
        USER_TYPE_ID: 'enumeration',
        FIELD_NAME: 'ENUMERATION_EXAMPLE',
        MULTIPLE: 'N',
        MANDATORY: 'N',
        SHOW_FILTER: 'Y',
        LIST: [
          { VALUE: 'List item #1', DEF: 'Y', XML_ID: 'XML_ID_1', SORT: 100 },
          { VALUE: 'List item #2', XML_ID: 'XML_ID_2', SORT: 200 },
          { VALUE: 'List item #3', XML_ID: 'XML_ID_3', SORT: 300 },
          { VALUE: 'List item #4', XML_ID: 'XML_ID_4', SORT: 400 },
        ],
        SETTINGS: {
          DISPLAY: 'UI',
          LIST_HEIGHT: 2,
        },
        SORT: 2000,
      },
    },
    requestId: Text.getUuidRfc4122()
  })

  // The payload is available only on a successful response
  if (!response.isSuccess) {
    console.error(response.getErrorMessages().join('; '))
  } else {
    const result = response.getData()!.result
    console.info('Created user field id:', result)
  }
} catch (error) {
  // Thrown on transport or SDK failures (AjaxError, SdkError, etc.)
  console.error(error)
}

<!-- Load the SDK (UMD build); it is exposed as the global B24Js -->
<script src="https://unpkg.com/@bitrix24/b24jssdk@1/dist/umd/index.min.js"></script>
<script>
  async function addLeadUserField() {
    try {
      // Initialize the SDK inside a Bitrix24 frame
      const $b24 = await B24Js.initializeB24Frame()

      const response = await $b24.actions.v2.call.make({
        method: 'crm.lead.userfield.add',
        params: {
          fields: {
            LABEL: 'Custom field (list)',
            USER_TYPE_ID: 'enumeration',
            FIELD_NAME: 'ENUMERATION_EXAMPLE',
            MULTIPLE: 'N',
            MANDATORY: 'N',
            SHOW_FILTER: 'Y',
            LIST: [
              { VALUE: 'List item #1', DEF: 'Y', XML_ID: 'XML_ID_1', SORT: 100 },
              { VALUE: 'List item #2', XML_ID: 'XML_ID_2', SORT: 200 },
              { VALUE: 'List item #3', XML_ID: 'XML_ID_3', SORT: 300 },
              { VALUE: 'List item #4', XML_ID: 'XML_ID_4', SORT: 400 },
            ],
            SETTINGS: {
              DISPLAY: 'UI',
              LIST_HEIGHT: 2,
            },
            SORT: 2000,
          },
        },
        requestId: B24Js.Text.getUuidRfc4122()
      })

      // The payload is available only on a successful response
      if (!response.isSuccess) {
        console.error(response.getErrorMessages().join('; '))
        return
      }

      const result = response.getData().result
      console.info('Created user field id:', result)
    } catch (error) {
      // Thrown on transport or SDK failures (AjaxError, SdkError, etc.)
      console.error(error)
    }
  }

  document.addEventListener('DOMContentLoaded', addLeadUserField)
</script>

from b24pysdk.errors import BitrixAPIError, BitrixSDKException

try:
    bitrix_response = client.crm.lead.userfield.add(
        fields={
            "LABEL": "Пользовательское поле (список)",
            "USER_TYPE_ID": "enumeration",
            "FIELD_NAME": "ENUMERATION_EXAMPLE",
            "MULTIPLE": "N",
            "MANDATORY": "N",
            "SHOW_FILTER": "Y",
            "LIST": [
                {
                    "VALUE": "Элемент списка #1",
                    "DEF": "Y",
                    "XML_ID": "XML_ID_1",
                    "SORT": 100,
                },
                {
                    "VALUE": "Элемент списка #2",
                    "XML_ID": "XML_ID_2",
                    "SORT": 200,
                },
                {
                    "VALUE": "Элемент списка #3",
                    "XML_ID": "XML_ID_3",
                    "SORT": 300,
                },
                {
                    "VALUE": "Элемент списка #4",
                    "XML_ID": "XML_ID_4",
                    "SORT": 400,
                },
            ],
            "SETTINGS": {
                "DISPLAY": "UI",
                "LIST_HEIGHT": 2,
            },
            "SORT": 2000,
        },
    ).response
    result = bitrix_response.result
    print(result)
except BitrixAPIError as error:
    print(
        "Ошибка Bitrix API",
        f"error: {error.error}",
        f"error_description: {error.error_description}",
        sep="\n",
    )
except BitrixSDKException as error:
    print(f"Ошибка Bitrix SDK: {error.message}")
except Exception as error:
    print(f"Непредвиденная ошибка: {error}")

try {
    $userfieldItemFields = [
        'LABEL' => 'Пользовательское поле (список)',
        'USER_TYPE_ID' => 'enumeration',
        'FIELD_NAME' => 'ENUMERATION_EXAMPLE',
        'MULTIPLE' => 'N',
        'MANDATORY' => 'N',
        'SHOW_FILTER' => 'Y',
        'LIST' => [
            ['VALUE' => 'Элемент списка #1', 'DEF' => 'Y', 'XML_ID' => 'XML_ID_1', 'SORT' => 100],
            ['VALUE' => 'Элемент списка #2', 'XML_ID' => 'XML_ID_2', 'SORT' => 200],
            ['VALUE' => 'Элемент списка #3', 'XML_ID' => 'XML_ID_3', 'SORT' => 300],
            ['VALUE' => 'Элемент списка #4', 'XML_ID' => 'XML_ID_4', 'SORT' => 400],
        ],
        'SETTINGS' => ['DISPLAY' => 'UI', 'LIST_HEIGHT' => 2],
        'SORT' => 2000,
    ];

    $result = $serviceBuilder
        ->getCRMScope()
        ->leadUserfield()
        ->add($userfieldItemFields);

    print($result->getId());
} catch (Throwable $e) {
    print('Error: ' . $e->getMessage());
}

BX24.callMethod(
    'crm.lead.userfield.add',
    {
        fields: {
            LABEL: 'Пользовательское поле (список)',
            USER_TYPE_ID: 'enumeration',
            FIELD_NAME: 'ENUMERATION_EXAMPLE',
            MULTIPLE: 'N',
            MANDATORY: 'N',
            SHOW_FILTER: 'Y',
            LIST: [
                { VALUE: 'Элемент списка #1', DEF: 'Y', XML_ID: 'XML_ID_1', SORT: 100 },
                { VALUE: 'Элемент списка #2', XML_ID: 'XML_ID_2', SORT: 200 },
                { VALUE: 'Элемент списка #3', XML_ID: 'XML_ID_3', SORT: 300 },
                { VALUE: 'Элемент списка #4', XML_ID: 'XML_ID_4', SORT: 400 },
            ],
            SETTINGS: { DISPLAY: 'UI', LIST_HEIGHT: 2 },
            SORT: 2000,
        },
    },
    (result) => {
        result.error()
            ? console.error(result.error())
            : console.info(result.data());
    }
);

require_once('crest.php');

$result = CRest::call(
    'crm.lead.userfield.add',
    [
        'fields' => [
            'LABEL' => 'Пользовательское поле (список)',
            'USER_TYPE_ID' => 'enumeration',
            'FIELD_NAME' => 'ENUMERATION_EXAMPLE',
            'MULTIPLE' => 'N',
            'MANDATORY' => 'N',
            'SHOW_FILTER' => 'Y',
            'LIST' => [
                ['VALUE' => 'Элемент списка #1', 'DEF' => 'Y', 'XML_ID' => 'XML_ID_1', 'SORT' => 100],
                ['VALUE' => 'Элемент списка #2', 'XML_ID' => 'XML_ID_2', 'SORT' => 200],
                ['VALUE' => 'Элемент списка #3', 'XML_ID' => 'XML_ID_3', 'SORT' => 300],
                ['VALUE' => 'Элемент списка #4', 'XML_ID' => 'XML_ID_4', 'SORT' => 400],
            ],
            'SETTINGS' => [
                'DISPLAY' => 'UI',
                'LIST_HEIGHT' => 2,
            ],
            'SORT' => 2000,
        ]
    ]
);

echo '<PRE>';
print_r($result);
echo '</PRE>';

// client и ctx уже созданы — см. раздел «SDK для Go»
res, err := client.Core().Call(ctx, "crm.lead.userfield.add", b24.Params{
	"fields": b24.Params{
		"LABEL":        "Пользовательское поле (список)",
		"USER_TYPE_ID": "enumeration",
		"FIELD_NAME":   "ENUMERATION_EXAMPLE",
		"MULTIPLE":     "N",
		"MANDATORY":    "N",
		"SHOW_FILTER":  "Y",
		"LIST": []b24.Params{
			{
				"VALUE":  "Элемент списка #1",
				"DEF":    "Y",
				"XML_ID": "XML_ID_1",
				"SORT":   100,
			},
			{
				"VALUE":  "Элемент списка #2",
				"XML_ID": "XML_ID_2",
				"SORT":   200,
			},
			{
				"VALUE":  "Элемент списка #3",
				"XML_ID": "XML_ID_3",
				"SORT":   300,
			},
			{
				"VALUE":  "Элемент списка #4",
				"XML_ID": "XML_ID_4",
				"SORT":   400,
			},
		},
		"SETTINGS": b24.Params{
			"DISPLAY":     "UI",
			"LIST_HEIGHT": 2,
		},
		"SORT": 2000,
	},
})
if err != nil {
	return fmt.Errorf("crm.lead.userfield.add: %w", err)
}

var newID b24.ID
if err := json.Unmarshal(res.Result, &newID); err != nil {
	return fmt.Errorf("разбор ответа: %w", err)
}
fmt.Println("идентификатор:", newID)