Для AI-агентов: markdown этой страницы — /docs-content/entities/companies/create.md индекс документации — /llms.txt

Создать компанию

POST /v1/companies

Создаёт новую компанию в CRM.

Поля запроса (body)

Параметр Тип Описание
title string Название компании
typeId string Тип компании: CUSTOMER, SUPPLIER, COMPETITOR. Список значений: GET /v1/statuses?filter[entityId]=COMPANY_TYPE
industry string Отрасль: IT, TELECOM, MANUFACTURING и др. Список: GET /v1/statuses?filter[entityId]=INDUSTRY
revenue number Годовой оборот
currencyId string Валюта оборота. Список: GET /v1/currencies
phone string | string[] | object[] Телефон. Принимает три формы: строка "+7...", массив строк ["+7...", "+7..."], или массив объектов [{ "value": "+7...", "typeId": "WORK" }, …]. typeId: WORK | HOME | MOBILE | OTHER (по умолчанию WORK). ⚠ UPPER-форма [{ "VALUE": "...", "VALUE_TYPE": "WORK" }] не принимается — вернёт 400 INVALID_MULTIFIELD_SHAPE. Используйте camelCase: [{ "value": "...", "typeId": "WORK" }]
email string | string[] | object[] Email. Принимает три формы: строка "a@b.com", массив строк ["a@b.com", "b@c.com"], или массив объектов [{ "value": "a@b.com", "typeId": "WORK" }, …]. typeId: WORK | HOME | MAILING | OTHER (по умолчанию WORK). ⚠ UPPER-форма [{ "VALUE": "...", "VALUE_TYPE": "WORK" }] не принимается — вернёт 400 INVALID_MULTIFIELD_SHAPE. Используйте camelCase: [{ "value": "...", "typeId": "WORK" }]
web string | string[] | object[] Веб-сайт. Принимает три формы: строка "https://acme.com", массив строк, или массив объектов [{ "value": "https://...", "typeId": "WORK" }]. typeId: WORK | HOME | OTHER (по умолчанию WORK). ⚠ UPPER-форма [{ "VALUE": "...", "VALUE_TYPE": "WORK" }] не принимается — вернёт 400 INVALID_MULTIFIELD_SHAPE. Используйте camelCase: [{ "value": "...", "typeId": "WORK" }]
comments string Комментарий
sourceId string Источник. Список: GET /v1/statuses?filter[entityId]=SOURCE
sourceDescription string Описание источника
assignedById number Ответственный. Список: GET /v1/users
opened boolean Доступна для всех
leadId number ID лида, из которого создана компания
ufCrm* по схеме поля Пользовательское поле портала, например ufCrmProjectCode. Рабочее имя и тип — в схеме GET /v1/companies/fields, формат значения по типам — Пользовательские поля (UF). В поле типа enumeration записывается ID варианта из массива items этого поля в схеме, в множественное поле — массив таких ID. Подпись VALUE на месте ID теряется: поле с одним значением получает 0. Число, которого нет среди вариантов, сохраняется как есть. Ни подпись, ни несуществующий ID не дают ошибки, ответ приходит с кодом 201, поэтому сопоставляйте подпись с ID на своей стороне и сверяйте сохранённое значение по этому полю в data ответа

Полный список полей: GET /v1/companies/fields.

Примеры

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

Terminal 
curl -X POST https://vibecode.bitrix24.tech/v1/companies \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "ООО Ромашка",
    "typeId": "CUSTOMER",
    "industry": "IT",
    "phone": "+74951234567",
    "email": "info@romashka.ru",
    "web": "https://romashka.ru"
  }'

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

Terminal 
curl -X POST https://vibecode.bitrix24.tech/v1/companies \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "ООО Ромашка",
    "typeId": "CUSTOMER",
    "industry": "IT",
    "phone": "+74951234567",
    "email": "info@romashka.ru",
    "web": "https://romashka.ru"
  }'

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

javascript 
const res = await fetch('https://vibecode.bitrix24.tech/v1/companies', {
  method: 'POST',
  headers: {
    'X-Api-Key': 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    title: 'ООО Ромашка',
    typeId: 'CUSTOMER',
    industry: 'IT',
    phone: '+74951234567',
    email: 'info@romashka.ru',
    web: 'https://romashka.ru',
  }),
})

const { success, data } = await res.json()
console.log('Company ID:', data.id)

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

javascript 
const res = await fetch('https://vibecode.bitrix24.tech/v1/companies', {
  method: 'POST',
  headers: {
    'X-Api-Key': 'YOUR_APP_KEY',
    'Authorization': 'Bearer USER_SESSION_TOKEN',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    title: 'ООО Ромашка',
    typeId: 'CUSTOMER',
    industry: 'IT',
    phone: '+74951234567',
    email: 'info@romashka.ru',
    web: 'https://romashka.ru',
  }),
})

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

Альтернативная форма — массив объектов с явным `typeId`

Если нужно указать несколько значений или явный тип (HOME, OTHER):

JSON 
{
  "phone": [
    { "value": "+74951234567", "typeId": "WORK" },
    { "value": "+74951112233", "typeId": "OTHER" }
  ],
  "email": [
    { "value": "info@romashka.ru", "typeId": "WORK" },
    { "value": "sales@romashka.ru", "typeId": "MAILING" }
  ],
  "web": [
    { "value": "https://romashka.ru", "typeId": "WORK" },
    { "value": "https://shop.romashka.ru", "typeId": "OTHER" }
  ]
}

Поля ответа

Поле Тип Описание
id number ID созданной компании
title string Название
typeId string Тип компании
industry string Отрасль
assignedById number Ответственный
createdBy number Создатель
createdTime datetime Дата создания
updatedTime datetime Дата изменения

Ответ содержит все поля компании, включая пользовательские (ufCrm*).

URL карточки компании в Битрикс24 строится из id:

https://<portal>.bitrix24.ru/crm/company/details/<id>/

<portal> — домен портала. Доступ ограничен правами сотрудника в Битрикс24.

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

JSON 
{
  "success": true,
  "data": {
    "id": 2923,
    "title": "ООО Ромашка",
    "typeId": "CUSTOMER",
    "industry": "IT",
    "revenue": 0,
    "currencyId": "RUB",
    "assignedById": 1,
    "createdBy": 1,
    "createdTime": "2026-04-15T12:53:59+03:00",
    "updatedTime": "2026-04-15T12:53:59+03:00",
    "opened": true
  }
}

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

403 — нет скоупа:

JSON 
{
  "success": false,
  "error": {
    "code": "SCOPE_DENIED",
    "message": "This endpoint requires 'crm' scope"
  }
}

Ошибки

HTTP Код Описание
403 SCOPE_DENIED API-ключ не имеет скоупа crm
401 TOKEN_MISSING API-ключ не имеет настроенных токенов
400 INVALID_REQUEST Невалидные поля
400 MULTIFIELD_ID_NOT_SUPPORTED В phone, email, web или в сыром fm[] передан объект с полем id. При создании адресовать нечего: Битрикс24 назначает идентификаторы записей мультиполя сам, поэтому запрос отклоняется и ничего не записывается

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

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