#Создать реквизит

POST /v1/requisites

Создаёт новый реквизит и привязывает его к контакту или компании CRM.

#Обязательные поля

Битрикс24 требует три поля для создания реквизита:

Поле Тип Допустимые значения Описание
entityTypeId number 3 (контакт), 4 (компания) Тип родительской сущности
entityId number любой существующий ID ID родительской сущности. Поиск: GET /v1/contacts или GET /v1/companies
presetId number любой существующий ID пресета ID пресета реквизита (определяет набор полей)

#Популярные поля

Все поля в camelCase. Полный список — `GET /v1/requisites/fields`.

#Общие

Параметр Тип По умолч. Описание
name string — Название реквизита, отображается в интерфейсе Битрикс24 (например, «Основной», «Для договоров»)
active boolean true Активен ли реквизит
sort number 500 Порядок сортировки (чем меньше — тем выше)
code / xmlId / originatorId string — Внешние идентификаторы для синхронизации
addressOnly boolean false Признак «только адрес» (для адресных справочников)

#Юрлица (российский пресет)

Параметр Тип Описание
rqName string Полное наименование
rqCompanyName string Сокращённое название
rqCompanyFullName string Полное название юрлица
rqCompanyRegDate date Дата регистрации
rqInn string ИНН
rqKpp string КПП
rqOgrn string ОГРН
rqOgrnip string ОГРНИП (для ИП)
rqOkpo / rqOkved / rqOktmo string Классификаторы
rqDirector string ФИО директора
rqAccountant string ФИО главного бухгалтера
rqCeoName / rqCeoWorkPos string ФИО и должность руководителя
rqContact / rqEmail / rqPhone / rqFax string Контакты организации
rqVatPayer boolean Плательщик НДС
rqVatId string ИНН для НДС (иностранные)
rqBaseDoc string Документ-основание деятельности (например, «Устав»)
rqResidenceCountry string Страна регистрации

#Физлица

Параметр Тип Описание
rqFirstName / rqLastName / rqSecondName string Имя / Фамилия / Отчество
rqIdentDocType string Название документа, удостоверяющего личность
rqIdentDocSer / rqIdentDocNum string Серия / Номер документа
rqIdentDocDate date Дата выдачи
rqIdentDocIssuedBy string Кем выдан
rqIdentDocDepCode string Код подразделения

#Международные пресеты

Поля для пресетов других стран (RQ_EDRPOU/Украина, RQ_KBE/Казахстан, RQ_REGON/Польша, RQ_SIRET/Франция, RQ_CNPJ/Бразилия) передаются в исходном UPPER_SNAKE_CASE — они не включены в Вайбкод-схему, но Битрикс24 их принимает.

#Примеры

#curl — личный ключ

Terminal 
curl -X POST "https://vibecode.bitrix24.tech/v1/requisites" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "entityTypeId": 4,
    "entityId": 15,
    "presetId": 1,
    "name": "Основной",
    "rqName": "ООО «Ромашка»",
    "rqInn": "7701234567",
    "rqKpp": "770101001",
    "rqOgrn": "1027700123456",
    "rqCompanyName": "Ромашка",
    "rqDirector": "Иванов Иван Иванович",
    "rqVatPayer": true
  }'

#curl — OAuth-приложение

Terminal 
curl -X POST "https://vibecode.bitrix24.tech/v1/requisites" \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "entityTypeId": 4,
    "entityId": 15,
    "presetId": 1,
    "name": "Основной",
    "rqName": "ООО «Ромашка»",
    "rqInn": "7701234567"
  }'

#JavaScript — личный ключ

javascript 
const res = await fetch('https://vibecode.bitrix24.tech/v1/requisites', {
  method: 'POST',
  headers: {
    'X-Api-Key': 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    entityTypeId: 4,
    entityId: 15,
    presetId: 1,
    name: 'Основной',
    rqName: 'ООО «Ромашка»',
    rqInn: '7701234567',
    rqKpp: '770101001',
    rqOgrn: '1027700123456',
    rqCompanyName: 'Ромашка',
    rqDirector: 'Иванов Иван Иванович',
    rqVatPayer: true,
  }),
})

const { success, data } = await res.json()
console.log('Создан реквизит ID:', data.id)

#JavaScript — OAuth-приложение

javascript 
const res = await fetch('https://vibecode.bitrix24.tech/v1/requisites', {
  method: 'POST',
  headers: {
    'X-Api-Key': 'YOUR_APP_KEY',
    'Authorization': 'Bearer USER_SESSION_TOKEN',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    entityTypeId: 4,
    entityId: 15,
    presetId: 1,
    rqName: 'ООО «Ромашка»',
    rqInn: '7701234567',
  }),
})

const { success, data } = await res.json()

#Поля ответа

Поле Тип Описание
success boolean Всегда true при успехе
data object Созданный реквизит
data.id number Идентификатор новой записи
data.entityTypeId / data.entityId / data.presetId number Переданные значения
data.name string | null Название реквизита
data.active boolean Активен ли реквизит (true по умолчанию)
data.sort number Порядок сортировки (500 по умолчанию)
data.createdAt / data.updatedAt datetime Совпадают при создании
data.createdBy number ID создателя
data.modifyBy number | null null сразу после создания

Ответ содержит все поля пресета реквизита в camelCase. Незаполненные поля — null. Полный список полей — Поля реквизита.

#Пример ответа

HTTP-статус: 201 Created

JSON 
{
  "success": true,
  "data": {
    "id": 42,
    "entityTypeId": 4,
    "entityId": 15,
    "presetId": 1,
    "name": "Основной",
    "active": true,
    "sort": 500,
    "createdAt": "2026-04-19T14:30:00+03:00",
    "updatedAt": "2026-04-19T14:30:00+03:00",
    "createdBy": 1,
    "modifyBy": null,
    "rqName": "ООО «Ромашка»",
    "rqInn": "7701234567",
    "rqKpp": "770101001",
    "rqOgrn": "1027700123456",
    "rqCompanyName": "Ромашка",
    "rqDirector": "Иванов Иван Иванович",
    "rqVatPayer": true,
    "rqAccountant": null,
    "rqCeoName": null,
    "rqOkpo": null,
    "rqOkved": null
  }
}

#Пример ответа при ошибке

400 — не указан presetId:

JSON 
{
  "success": false,
  "error": {
    "code": "BITRIX_ERROR",
    "message": "PRESET_ID field value is not specified"
  }
}

#Ошибки

HTTP Код Описание
400 INVALID_REQUEST Не указаны обязательные поля (entityTypeId, entityId, presetId) или невалидные значения
422 BITRIX_ERROR Битрикс24 отклонил значение одного из полей (например, несуществующий presetId)
403 ACCESS_DENIED Нет доступа к родительской компании/контакту
403 SCOPE_DENIED API-ключ не имеет скоупа crm
401 TOKEN_MISSING API-ключ не имеет настроенных токенов

Полный список общих ошибок API — Ошибки.

#Известные особенности

Поля, которых нет в пресете, игнорируются. Если передать поле, которого нет в выбранном пресете, Битрикс24 молча его проигнорирует — ошибка не возникнет, но и значение не сохранится.

#Смотрите также