[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"docs-entities\u002Factivities\u002Fcreate":3,"docs-tabs-entities\u002Factivities\u002Fcreate":6},{"content":4,"lastmod":5},"\n## Создать дело\n\n`POST \u002Fv1\u002Factivities`\n\nСоздаёт новое CRM-дело: звонок, встречу, задачу или email. Дело привязывается к CRM-сущности через `ownerTypeId` + `ownerId`.\n\n## Поля запроса (body)\n\nМинимальный набор для создания дела — `subject`, `typeId`, `communications` плюс **привязка** к CRM-сущности. Привязку задаёт **либо** пара `ownerTypeId` + `ownerId`, **либо** поля `entityTypeId` + `entityId` внутри элемента `communications`. Если не задано ни одно из двух, Bitrix24 не может привязать коммуникацию и возвращает ошибку про `communications`.\n\n| Параметр | Тип | Обяз. | Описание |\n|----------|-----|:-----:|---------|\n| `subject` | string | да | Тема дела |\n| `typeId` | number | да | Тип: `1` — встреча, `2` — звонок, `3` — задача, `4` — письмо, `5` — действие, `6` — пользовательское действие |\n| `communications` | object[] | да | Коммуникации дела. Массив объектов: `[{ \"value\": \"+7…\", \"entityTypeId\": 3, \"entityId\": 17 }]`. Вложенные ключи принимаются в camelCase (`type`, `value`, `entityTypeId`, `entityId`) — как и во всём остальном API — либо в ВЕРХНЕМ регистре Bitrix24 (`TYPE`, `VALUE`, `ENTITY_TYPE_ID`, `ENTITY_ID`). `value` — телефон\u002Fe-mail; `entityTypeId` + `entityId` — CRM-сущность, которой принадлежит коммуникация (задаёт привязку, если не переданы `ownerTypeId`\u002F`ownerId`). Когда владелец указан, достаточно `[{ \"value\": \"+7…\" }]` |\n| `ownerTypeId` | number | да¹ | Тип родительской сущности: `1` — лид, `2` — сделка, `3` — контакт, `4` — компания |\n| `ownerId` | number | да¹ | ID родительской сущности. Поиск: `GET \u002Fv1\u002Fdeals`, `GET \u002Fv1\u002Fleads`, `GET \u002Fv1\u002Fcontacts`, `GET \u002Fv1\u002Fcompanies` |\n| `responsibleId` | number | | Ответственный. По умолчанию — текущий пользователь. Список: `GET \u002Fv1\u002Fusers` |\n| `description` | string | | Описание |\n| `priority` | number | | Приоритет: `1` — низкий, `2` — средний, `3` — высокий |\n| `direction` | number | | Направление: `1` — входящее, `2` — исходящее |\n| `completed` | boolean | | Завершена |\n| `startTime` | datetime | | Дата начала |\n| `endTime` | datetime | | Дата окончания |\n| `deadline` | datetime | | Крайний срок. **На создании Bitrix24 игнорирует переданное значение и вычисляет `deadline` из `startTime`\u002F`endTime`** — отдельно задать его при `POST` нельзя |\n\n¹ Пара `ownerTypeId` + `ownerId` нужна вместе и **только если** привязка не задана через `entityTypeId`\u002F`entityId` внутри `communications`. Если привязка идёт через коммуникацию — оба поля можно опустить.\n\n> ℹ️ Вложенные ключи `communications` принимаются в двух формах: camelCase (`type`, `value`, `entityTypeId`, `entityId`) — единообразно с остальным API — и в ВЕРХНЕМ регистре Bitrix24 (`TYPE`, `VALUE`, `ENTITY_TYPE_ID`, `ENTITY_ID`). Если в одном объекте заданы обе формы одного ключа, приоритет у ВЕРХНЕГО регистра.\n\nПолный список полей: [GET \u002Fv1\u002Factivities\u002Ffields](\u002Fdocs\u002Fentities\u002Factivities\u002Ffields).\n\n## Примеры\n\n### curl — личный ключ\n\n```bash\ncurl -X POST https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Factivities \\\n  -H \"X-Api-Key: YOUR_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"typeId\": 2,\n    \"ownerTypeId\": 3,\n    \"ownerId\": 17,\n    \"subject\": \"Звонок клиенту\",\n    \"description\": \"Обсудить условия поставки\",\n    \"responsibleId\": 1,\n    \"priority\": 2,\n    \"direction\": 2,\n    \"communications\": [\n      { \"value\": \"+7 999 123-45-67\", \"entityTypeId\": 3, \"entityId\": 17 }\n    ],\n    \"startTime\": \"2026-04-16T10:00:00+03:00\",\n    \"endTime\": \"2026-04-16T10:15:00+03:00\"\n  }'\n```\n\n### curl — OAuth-приложение\n\n```bash\ncurl -X POST https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Factivities \\\n  -H \"X-Api-Key: YOUR_APP_KEY\" \\\n  -H \"Authorization: Bearer USER_SESSION_TOKEN\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"typeId\": 2,\n    \"ownerTypeId\": 3,\n    \"ownerId\": 17,\n    \"subject\": \"Звонок клиенту\",\n    \"description\": \"Обсудить условия поставки\",\n    \"responsibleId\": 1,\n    \"priority\": 2,\n    \"direction\": 2,\n    \"communications\": [\n      { \"value\": \"+7 999 123-45-67\", \"entityTypeId\": 3, \"entityId\": 17 }\n    ],\n    \"startTime\": \"2026-04-16T10:00:00+03:00\",\n    \"endTime\": \"2026-04-16T10:15:00+03:00\"\n  }'\n```\n\n### JavaScript — личный ключ\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Factivities', {\n  method: 'POST',\n  headers: {\n    'X-Api-Key': 'YOUR_API_KEY',\n    'Content-Type': 'application\u002Fjson',\n  },\n  body: JSON.stringify({\n    typeId: 2,\n    ownerTypeId: 3,\n    ownerId: 17,\n    subject: 'Звонок клиенту',\n    description: 'Обсудить условия поставки',\n    responsibleId: 1,\n    priority: 2,\n    direction: 2,\n    communications: [\n      { value: '+7 999 123-45-67', entityTypeId: 3, entityId: 17 },\n    ],\n    startTime: '2026-04-16T10:00:00+03:00',\n    endTime: '2026-04-16T10:15:00+03:00',\n  }),\n})\n\nconst { success, data } = await res.json()\nconsole.log('Activity ID:', data.id)\n```\n\n### JavaScript — OAuth-приложение\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Factivities', {\n  method: 'POST',\n  headers: {\n    'X-Api-Key': 'YOUR_APP_KEY',\n    'Authorization': 'Bearer USER_SESSION_TOKEN',\n    'Content-Type': 'application\u002Fjson',\n  },\n  body: JSON.stringify({\n    typeId: 2,\n    ownerTypeId: 3,\n    ownerId: 17,\n    subject: 'Звонок клиенту',\n    description: 'Обсудить условия поставки',\n    responsibleId: 1,\n    priority: 2,\n    direction: 2,\n    communications: [\n      { value: '+7 999 123-45-67', entityTypeId: 3, entityId: 17 },\n    ],\n    startTime: '2026-04-16T10:00:00+03:00',\n    endTime: '2026-04-16T10:15:00+03:00',\n  }),\n})\n\nconst { success, data } = await res.json()\n```\n\n## Поля ответа\n\n| Поле | Тип | Описание |\n|------|-----|---------|\n| `id` | number | ID созданного дела |\n| `typeId` | number | Тип дела |\n| `ownerTypeId` | number | Тип родительской сущности |\n| `ownerId` | number | ID родительской сущности |\n| `subject` | string | Тема |\n| `responsibleId` | number | Ответственный |\n| `createdAt` | datetime | Дата создания |\n| `updatedAt` | datetime | Дата изменения |\n\nОтвет содержит все поля дела.\n\n## Пример ответа\n\n```json\n{\n  \"success\": true,\n  \"data\": {\n    \"id\": 3894,\n    \"typeId\": 2,\n    \"ownerTypeId\": 3,\n    \"ownerId\": 17,\n    \"subject\": \"Звонок клиенту\",\n    \"description\": \"Обсудить условия поставки\",\n    \"responsibleId\": 1,\n    \"priority\": 2,\n    \"direction\": 2,\n    \"completed\": false,\n    \"startTime\": \"2026-04-16T10:00:00+03:00\",\n    \"endTime\": \"2026-04-16T10:15:00+03:00\",\n    \"deadline\": \"2026-04-16T10:00:00+03:00\",\n    \"createdAt\": \"2026-04-15T14:30:00+03:00\",\n    \"updatedAt\": \"2026-04-15T14:30:00+03:00\"\n  }\n}\n```\n\n## Пример ответа при ошибке\n\n400 — не передано обязательное поле (`subject`, `typeId` или `communications`):\n\n```json\n{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"MISSING_REQUIRED_FIELDS\",\n    \"message\": \"Body field \\\"communications\\\" is required to create activity.\"\n  }\n}\n```\n\n403 — нет скоупа:\n\n```json\n{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"SCOPE_DENIED\",\n    \"message\": \"This endpoint requires 'crm' scope\"\n  }\n}\n```\n\n## Ошибки\n\n| HTTP | Код | Описание |\n|------|-----|---------|\n| 400 | `MISSING_REQUIRED_FIELDS` | Не передано одно из обязательных полей: `subject`, `typeId`, `communications` (проверяется до вызова Bitrix24) |\n| 400 | `INVALID_REQUEST` | Невалидные значения полей |\n| 403 | `SCOPE_DENIED` | API-ключ не имеет скоупа `crm` |\n| 401 | `TOKEN_MISSING` | API-ключ не имеет настроенных токенов |\n\nПолный список общих ошибок API — [Ошибки](\u002Fdocs\u002Ferrors).\n\n## Смотрите также\n\n- [Список дел](\u002Fdocs\u002Fentities\u002Factivities\u002Flist) — получение с фильтрами\n- [Поля дела](\u002Fdocs\u002Fentities\u002Factivities\u002Ffields) — полный список полей\n- [Сделки](\u002Fdocs\u002Fentities\u002Fdeals) — привязка через `ownerTypeId=2`\n- [Лиды](\u002Fdocs\u002Fentities\u002Fleads) — привязка через `ownerTypeId=1`\n- [Entity API](\u002Fdocs\u002Fentity-api) — общие принципы\n- [Лимиты и оптимизация](\u002Fdocs\u002Foptimization) — rate limits\n","2026-07-20",{}]