[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"docs-entities\u002Factivities\u002Fconfigurable\u002Fcreate":3,"docs-tabs-entities\u002Factivities\u002Fconfigurable\u002Fcreate":6},{"content":4,"lastmod":5},"\n## Создать дело\n\n`POST \u002Fv1\u002Factivity-configurable`\n\nСоздаёт конфигурируемое дело в таймлайне CRM-сущности. Набор полей дела задаёт `fields`, внешний вид — `layout`.\n\n## Поля запроса (body)\n\n| Поле | Тип | Обяз. | Описание |\n|------|-----|:-----:|---------|\n| **`ownerTypeId`** | number | да | Тип CRM-сущности:\u003Cbr>1 — лид\u003Cbr>2 — сделка\u003Cbr>3 — контакт\u003Cbr>4 — компания\u003Cbr>7 — предложение\u003Cbr>31 — счёт\u003Cbr>≥128 — смарт-процесс, id типа — в [`GET \u002Fv1\u002Fsmart-processes`](\u002Fdocs\u002Fentities\u002Fsmart-processes\u002Flist) |\n| **`ownerId`** | number | да | ID сущности, в таймлайне которой создаётся дело |\n| **`fields`** | object | да | Поля дела |\n| `fields.typeId` | string | нет | Тип дела. По умолчанию `CONFIGURABLE`. Свой тип регистрируется в Битрикс24 как конфигурируемый в контексте того же приложения |\n| `fields.completed` | boolean | нет | Дело закрыто. Принимает `true`\u002F`false`, `1`\u002F`0`, `Y`\u002F`N` |\n| `fields.deadline` | string | нет | Крайний срок исполнения, ISO 8601. Несовместим с `fields.isIncomingChannel` |\n| `fields.pingOffsets` | number[] | нет | Смещения в минутах относительно `fields.deadline`, в которые формируются напоминания |\n| `fields.isIncomingChannel` | boolean | нет | Дело создано из входящего канала. Принимает `true`\u002F`false`, `1`\u002F`0`, `Y`\u002F`N` |\n| `fields.responsibleId` | number | нет | ID ответственного сотрудника. Список: `GET \u002Fv1\u002Fusers` |\n| `fields.badgeCode` | string | нет | Код значка дела на канбане |\n| `fields.originatorId` | string | нет | ID внешнего источника данных |\n| `fields.originId` | string | нет | ID записи во внешнем источнике |\n| **`layout`** | object | да | Оформление дела в таймлайне |\n| `layout.icon.code` | string | да | Код иконки дела |\n| `layout.header.title` | string | да | Заголовок дела |\n| `layout.body.logo.code` | string | да | Код логотипа в теле. Тело без `logo` Битрикс24 отклоняет |\n| `layout.body.blocks` | object | нет | Именованные блоки тела |\n| `layout.footer.buttons` | object | нет | Кнопки футера |\n\nБлок в `layout.body.blocks` имеет `type` и `properties`. Основные типы блоков:\n\n- `text` — значение\n- `link` — ссылка с действием\n- `lineOfBlocks` — строка из вложенных блоков\n- `withTitle` — блок с подписью\n\nДействие у ссылок и кнопок задаёт поле `type`:\n\n- `redirect` — переход по адресу из поля `uri`\n- `openRestApp` — открытие приложения с параметрами `actionParams`\n- `restEvent` — событие приложению по `id`, для пунктов меню\n\n## Примеры\n\nПримеры приведены только для OAuth-приложения.\n\n### curl — OAuth-приложение\n\n```bash\ncurl -X POST https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Factivity-configurable \\\n  -H \"X-Api-Key: YOUR_APP_KEY\" \\\n  -H \"Authorization: Bearer USER_SESSION_TOKEN\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"ownerTypeId\": 1,\n    \"ownerId\": 999,\n    \"fields\": { \"typeId\": \"CONFIGURABLE\", \"completed\": true, \"responsibleId\": 1, \"badgeCode\": \"CUSTOM\" },\n    \"layout\": {\n      \"icon\": { \"code\": \"call-completed\" },\n      \"header\": { \"title\": \"Входящий звонок\" },\n      \"body\": {\n        \"logo\": { \"code\": \"call-incoming\" },\n        \"blocks\": {\n          \"phone\": { \"type\": \"text\", \"properties\": { \"value\": \"+7 999 888 7777\" } }\n        }\n      },\n      \"footer\": {\n        \"buttons\": {\n          \"startCall\": {\n            \"title\": \"О клиенте\",\n            \"type\": \"primary\",\n            \"action\": { \"type\": \"openRestApp\", \"actionParams\": { \"clientId\": 456 } }\n          }\n        }\n      }\n    }\n  }'\n```\n\n### JavaScript — OAuth-приложение\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Factivity-configurable', {\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    ownerTypeId: 1,\n    ownerId: 999,\n    fields: { typeId: 'CONFIGURABLE', completed: true, responsibleId: 1, badgeCode: 'CUSTOM' },\n    layout: {\n      icon: { code: 'call-completed' },\n      header: { title: 'Входящий звонок' },\n      body: {\n        logo: { code: 'call-incoming' },\n        blocks: {\n          phone: { type: 'text', properties: { value: '+7 999 888 7777' } },\n        },\n      },\n      footer: {\n        buttons: {\n          startCall: {\n            title: 'О клиенте',\n            type: 'primary',\n            action: { type: 'openRestApp', actionParams: { clientId: 456 } },\n          },\n        },\n      },\n    },\n  }),\n})\n\nconst { data } = await res.json()\nconsole.log('Activity ID:', data.activity.id)\n```\n\n## Поля ответа\n\n| Поле | Тип | Описание |\n|------|-----|---------|\n| `success` | boolean | Всегда `true` при успехе |\n| `data.activity.id` | number | ID созданного дела |\n\n## Пример ответа\n\n```json\n{\n  \"success\": true,\n  \"data\": { \"activity\": { \"id\": 8053 } }\n}\n```\n\n## Пример ответа при ошибке\n\n422 — не заполнен `logo` в теле:\n\n```json\n{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"BITRIX_ERROR\",\n    \"message\": \"Поле logo в BodyDto должно быть заполнено.\"\n  }\n}\n```\n\n## Ошибки\n\n| HTTP | Код | Описание |\n|------|-----|---------|\n| 400 | `VALIDATION_ERROR` | Не передан `ownerTypeId`, `ownerId`, `fields` или `layout` |\n| 422 | `BITRIX_ERROR` | Битрикс24 отклонил запрос: пустой `layout`, не заполнен `layout.body.logo`, вызов вне контекста приложения, входящее дело с `deadline` |\n| 403 | `SCOPE_DENIED` | Ключу не хватает скоупа `crm` |\n| 401 | `TOKEN_MISSING` | Ключ авторизации передан без токена сессии в заголовке `Authorization: Bearer` |\n\nПолный список общих ошибок API — [Ошибки](\u002Fdocs\u002Ferrors).\n\n## Известные особенности\n\n**Только в контексте приложения.** Нужен ключ авторизации `vibe_app_*` с токеном сессии в заголовке `Authorization: Bearer`. Персональный API-ключ `vibe_api_*` Битрикс24 отклоняет с `ERROR_WRONG_CONTEXT`.\n\n## Смотрите также\n\n- [Получить дело](\u002Fdocs\u002Fentities\u002Factivities\u002Fconfigurable\u002Fget)\n- [Обновить дело](\u002Fdocs\u002Fentities\u002Factivities\u002Fconfigurable\u002Fupdate)\n- [Конфигурируемые дела](\u002Fdocs\u002Fentities\u002Factivities\u002Fconfigurable)\n- [Дела](\u002Fdocs\u002Fentities\u002Factivities)\n","2026-06-24",{}]