#Создать контакт

POST /v1/contacts

Создаёт новый контакт в CRM.

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

Параметр Тип Описание
name string Имя
lastName string Фамилия
secondName string Отчество
phone string/array Телефон. Строка или массив: [{ "value": "+7...", "typeId": "WORK" }]
email string/array Email. Строка или массив: [{ "value": "a@b.com", "typeId": "WORK" }]
companyId number ID компании. Поиск: GET /v1/companies
post string Должность
comments string Комментарий
typeId string Тип контакта. Список: GET /v1/statuses?filter[entityId]=CONTACT_TYPE
sourceId string Источник. Список: GET /v1/statuses?filter[entityId]=SOURCE
sourceDescription string Описание источника
assignedById number Ответственный. Список: GET /v1/users
opened boolean Доступен для всех
leadId number ID лида, из которого создан контакт

Полный список полей: GET /v1/contacts/fields. Пользовательские поля (ufCrm_*) также принимаются.

#Примеры

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

Terminal 
curl -X POST https://vibecode.bitrix24.tech/v1/contacts \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Иван",
    "lastName": "Петров",
    "phone": [{ "value": "+79161234567", "typeId": "WORK" }],
    "email": [{ "value": "ivan@company.ru", "typeId": "WORK" }],
    "companyId": 15,
    "post": "Менеджер",
    "typeId": "CLIENT"
  }'

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

Terminal 
curl -X POST https://vibecode.bitrix24.tech/v1/contacts \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Иван",
    "lastName": "Петров",
    "phone": [{ "value": "+79161234567", "typeId": "WORK" }],
    "email": [{ "value": "ivan@company.ru", "typeId": "WORK" }],
    "companyId": 15,
    "post": "Менеджер",
    "typeId": "CLIENT"
  }'

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

javascript 
const res = await fetch('https://vibecode.bitrix24.tech/v1/contacts', {
  method: 'POST',
  headers: {
    'X-Api-Key': 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    name: 'Иван',
    lastName: 'Петров',
    phone: [{ value: '+79161234567', typeId: 'WORK' }],
    email: [{ value: 'ivan@company.ru', typeId: 'WORK' }],
    companyId: 15,
    post: 'Менеджер',
    typeId: 'CLIENT',
  }),
})

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

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

javascript 
const res = await fetch('https://vibecode.bitrix24.tech/v1/contacts', {
  method: 'POST',
  headers: {
    'X-Api-Key': 'YOUR_APP_KEY',
    'Authorization': 'Bearer USER_SESSION_TOKEN',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    name: 'Иван',
    lastName: 'Петров',
    phone: [{ value: '+79161234567', typeId: 'WORK' }],
    email: [{ value: 'ivan@company.ru', typeId: 'WORK' }],
    companyId: 15,
    post: 'Менеджер',
    typeId: 'CLIENT',
  }),
})

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

#Поля ответа

Поле Тип Описание
id number ID созданного контакта
name string Имя
lastName string Фамилия
companyId number ID компании
assignedById number Ответственный
createdBy number Создатель
createdTime datetime Дата создания
updatedTime datetime Дата изменения
typeId string Тип контакта
sourceId string Источник

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

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

JSON 
{
  "success": true,
  "data": {
    "id": 2457,
    "name": "Иван",
    "lastName": "Петров",
    "secondName": null,
    "companyId": 15,
    "assignedById": 1,
    "createdBy": 1,
    "createdTime": "2026-04-15T12:26:17+03:00",
    "updatedTime": "2026-04-15T12:26:17+03:00",
    "opened": true,
    "typeId": "CLIENT",
    "sourceId": "CALL",
    "post": "Менеджер"
  }
}

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

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 Невалидные поля

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

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