#Создать дело

POST /v1/activities

Создаёт новое CRM-дело: звонок, встречу, задачу или email. Дело привязывается к CRM-сущности через ownerTypeId + ownerId.

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

Параметр Тип Описание
typeId number Тип: 1 — звонок, 2 — встреча, 3 — задача, 6 — email
ownerTypeId number Тип родительской сущности: 1 — лид, 2 — сделка, 3 — контакт, 4 — компания
ownerId number ID родительской сущности. Поиск: GET /v1/deals, GET /v1/leads, GET /v1/contacts
subject string Тема дела
description string Описание
responsibleId number Ответственный. Список: GET /v1/users
priority number Приоритет: 1 — низкий, 2 — средний, 3 — высокий
direction number Направление: 1 — входящее, 2 — исходящее
completed boolean Завершена
startTime datetime Дата начала
endTime datetime Дата окончания
deadline datetime Крайний срок

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

#Примеры

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

Terminal 
curl -X POST https://vibecode.bitrix24.tech/v1/activities \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "typeId": 2,
    "ownerTypeId": 2,
    "ownerId": 741,
    "subject": "Встреча по проекту",
    "description": "Обсуждение условий поставки",
    "responsibleId": 1,
    "priority": 2,
    "direction": 2,
    "startTime": "2026-04-16T10:00:00+03:00",
    "endTime": "2026-04-16T11:00:00+03:00",
    "deadline": "2026-04-16T11:00:00+03:00"
  }'

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

Terminal 
curl -X POST https://vibecode.bitrix24.tech/v1/activities \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "typeId": 2,
    "ownerTypeId": 2,
    "ownerId": 741,
    "subject": "Встреча по проекту",
    "description": "Обсуждение условий поставки",
    "responsibleId": 1,
    "priority": 2,
    "direction": 2,
    "startTime": "2026-04-16T10:00:00+03:00",
    "endTime": "2026-04-16T11:00:00+03:00",
    "deadline": "2026-04-16T11:00:00+03:00"
  }'

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

javascript 
const res = await fetch('https://vibecode.bitrix24.tech/v1/activities', {
  method: 'POST',
  headers: {
    'X-Api-Key': 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    typeId: 2,
    ownerTypeId: 2,
    ownerId: 741,
    subject: 'Встреча по проекту',
    description: 'Обсуждение условий поставки',
    responsibleId: 1,
    priority: 2,
    direction: 2,
    startTime: '2026-04-16T10:00:00+03:00',
    endTime: '2026-04-16T11:00:00+03:00',
    deadline: '2026-04-16T11:00:00+03:00',
  }),
})

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

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

javascript 
const res = await fetch('https://vibecode.bitrix24.tech/v1/activities', {
  method: 'POST',
  headers: {
    'X-Api-Key': 'YOUR_APP_KEY',
    'Authorization': 'Bearer USER_SESSION_TOKEN',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    typeId: 2,
    ownerTypeId: 2,
    ownerId: 741,
    subject: 'Встреча по проекту',
    description: 'Обсуждение условий поставки',
    responsibleId: 1,
    priority: 2,
    direction: 2,
    startTime: '2026-04-16T10:00:00+03:00',
    endTime: '2026-04-16T11:00:00+03:00',
    deadline: '2026-04-16T11:00:00+03:00',
  }),
})

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

#Поля ответа

Поле Тип Описание
id number ID созданного дела
typeId number Тип дела
ownerTypeId number Тип родительской сущности
ownerId number ID родительской сущности
subject string Тема
responsibleId number Ответственный
createdAt datetime Дата создания
updatedAt datetime Дата изменения

Ответ содержит все поля дела.

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

JSON 
{
  "success": true,
  "data": {
    "id": 3894,
    "typeId": 2,
    "ownerTypeId": 2,
    "ownerId": 741,
    "subject": "Встреча по проекту",
    "description": "Обсуждение условий поставки",
    "responsibleId": 1,
    "priority": 2,
    "direction": 2,
    "completed": false,
    "startTime": "2026-04-16T10:00:00+03:00",
    "endTime": "2026-04-16T11:00:00+03:00",
    "deadline": "2026-04-16T11:00:00+03:00",
    "createdAt": "2026-04-15T14:30:00+03:00",
    "updatedAt": "2026-04-15T14:30:00+03:00"
  }
}

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

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 — Ошибки.

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