метод REST scope: crm

crm.status.add

Создать элемент справочника

Кто может выполнять: пользователь с правами администратора CRM

Описание

Метод crm.status.add создает новый элемент в указанном справочнике CRM: стадия сделки, источник, тип компании и другие.

Параметры

fields object обязательный

Объект с полями нового элемента справочника. Список доступных полей описан ниже

Параметр fields

ENTITY_ID string обязательный

Тип справочника, например DEAL_STAGE, SOURCE. Получить список типов можно методом crm.status.entity.types

STATUS_ID string обязательный

Код значения статуса. Код должен быть уникальным в рамках справочника. Ограничения по длине и символам зависят от типа справочника

NAME string обязательный

Название

SORT integer необязательный

Сортировка. По умолчанию 10

COLOR string необязательный

Цвет hex-код, например #39A8EF. Используйте для статусов-стадий

SEMANTICS string необязательный

Группа стадий:
- "S" — «Успех»,
- "F" — «Провал»,
- "" — «В работе».

Используйте для статусов-стадий. По умолчанию передается группа «В работе»

Примеры запроса

curl -X POST \
     -H "Content-Type: application/json" \
     -H "Accept: application/json" \
     -d '{"fields":{"ENTITY_ID":"DEAL_STAGE_1","STATUS_ID":"DECISION","NAME":"Принятие решения","SORT":70,"COLOR":"#FFA900"}}' \
     https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/crm.status.add

Ответ

HTTP-статус: 200

{
    "result": 773,
    "time": {
        "start": 1752215174.862923,
        "finish": 1752215174.916697,
        "duration": 0.053774118423461914,
        "processing": 0.014070987701416016,
        "date_start": "2025-07-11T09:26:14+03:00",
        "date_finish": "2025-07-11T09:26:14+03:00",
        "operating_reset_at": 1752215774,
        "operating": 0
    }
}

Возвращаемые данные

result integer

Идентификатор созданного элемента справочника

time time

Информация о времени выполнения запроса

Обработка ошибок

HTTP-статус: 400

{
    "error": "",
    "error_description": "The field STATUS_ID is required."
}
Код Описание Значение
400 Пустое значение The field ENTITY_ID is required., The field STATUS_ID is required.
400 Пустое значение Parameter 'fields' must be array.
400 Пустое значение Specified entity type is not supported.
400 Пустое значение Не заполнено обязательное поле "Заголовок"
400 Пустое значение Нельзя создать промежуточную стадию после успешной
400 Пустое значение Access denied.
400 Пустое значение Error on creating status.
400 ERROR_CORE Указанный идентификатор статуса, уже существует.

Что будем искать? Например,Продвижение

Этот сайт использует куки-файлы. Оставаясь на сайте, Вы соглашаетесь на их использование. Для получения дополнительной информации, пожалуйста, ознакомьтесь с политикой в отношении персональных данных.