[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"docs-entities\u002Fdeals\u002Fcreate":3,"docs-tabs-entities\u002Fdeals\u002Fcreate":6},{"content":4,"lastmod":5},"\n## Создать сделку\n\n`POST \u002Fv1\u002Fdeals`\n\nСоздаёт новую сделку в CRM.\n\n## Поля запроса (body)\n\n| Параметр | Тип | Описание |\n|----------|-----|---------|\n| `title` | string | Название сделки |\n| `amount` | number | Сумма |\n| `currency` | string | Валюта. Список: `GET \u002Fv1\u002Fcurrencies` |\n| `stageId` | string | Стадия воронки. Стандартные: `NEW`, `PREPARATION`, `PREPAYMENT_INVOICE`, `EXECUTING`, `FINAL_INVOICE`, `WON`, `LOSE`. Портал может иметь свои — список: `GET \u002Fv1\u002Fstatuses?filter[entityId]=DEAL_STAGE` |\n| `categoryId` | number | ID воронки (0 = основная). Список: `GET \u002Fv1\u002Fdeal-categories` |\n| `companyId` | number | ID компании. Поиск: `GET \u002Fv1\u002Fcompanies` |\n| `contactId` | number | ID основного контакта. Поиск: `GET \u002Fv1\u002Fcontacts` |\n| `assignedById` | number | ID ответственного. Список сотрудников: `GET \u002Fv1\u002Fusers` |\n| `sourceId` | string | Источник. Список: `GET \u002Fv1\u002Fstatuses?filter[entityId]=SOURCE` |\n| `sourceDescription` | string | Описание источника |\n| `comments` | string | Комментарий |\n| `opened` | boolean | Доступна для всех |\n| `closedAt` | datetime | Дата закрытия |\n| `probability` | number | Вероятность успеха (%) |\n| `observers` | number[] | Массив ID наблюдателей. Список сотрудников: `GET \u002Fv1\u002Fusers` |\n\nПолный список полей: [GET \u002Fv1\u002Fdeals\u002Ffields](\u002Fdocs\u002Fentities\u002Fdeals\u002Ffields). Пользовательские поля (`ufCrm_*`) также принимаются.\n\n## Примеры\n\n### curl — личный ключ\n\n```bash\ncurl -X POST https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fdeals \\\n  -H \"X-Api-Key: YOUR_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"title\": \"Поставка оборудования\",\n    \"amount\": 50000,\n    \"currency\": \"RUB\",\n    \"stageId\": \"NEW\",\n    \"categoryId\": 0,\n    \"assignedById\": 1\n  }'\n```\n\n### curl — OAuth-приложение\n\n```bash\ncurl -X POST https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fdeals \\\n  -H \"X-Api-Key: YOUR_APP_KEY\" \\\n  -H \"Authorization: Bearer USER_SESSION_TOKEN\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"title\": \"Поставка оборудования\",\n    \"amount\": 50000,\n    \"currency\": \"RUB\",\n    \"stageId\": \"NEW\",\n    \"categoryId\": 0,\n    \"assignedById\": 1\n  }'\n```\n\n### JavaScript — личный ключ\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fdeals', {\n  method: 'POST',\n  headers: {\n    'X-Api-Key': 'YOUR_API_KEY',\n    'Content-Type': 'application\u002Fjson',\n  },\n  body: JSON.stringify({\n    title: 'Поставка оборудования',\n    amount: 50000,\n    currency: 'RUB',\n    stageId: 'NEW',\n    categoryId: 0,\n    assignedById: 1,\n  }),\n})\n\nconst { success, data } = await res.json()\nconsole.log('Deal ID:', data.id)\n```\n\n### JavaScript — OAuth-приложение\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fdeals', {\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    title: 'Поставка оборудования',\n    amount: 50000,\n    currency: 'RUB',\n    stageId: 'NEW',\n    categoryId: 0,\n    assignedById: 1,\n  }),\n})\n\nconst { success, data } = await res.json()\n```\n\n## Поля ответа\n\n| Поле | Тип | Описание |\n|------|-----|---------|\n| `id` | number | ID созданной сделки |\n| `title` | string | Название |\n| `amount` | number | Сумма |\n| `currency` | string | Валюта |\n| `stageId` | string | Стадия |\n| `categoryId` | number | ID воронки |\n| `assignedById` | number | Ответственный |\n| `createdBy` | number | Создатель |\n| `createdAt` | datetime | Дата создания |\n| `updatedAt` | datetime | Дата изменения |\n| `entityTypeId` | number | Тип сущности (2 = сделки) |\n\nОтвет содержит все поля сделки, включая пользовательские (`ufCrm_*`). Выше показаны основные.\n\nURL карточки сделки в Битрикс24 строится из `id`:\n\n```\nhttps:\u002F\u002F\u003Cportal>.bitrix24.ru\u002Fcrm\u002Fdeal\u002Fdetails\u002F\u003Cid>\u002F\n```\n\n`\u003Cportal>` — домен портала. Доступ ограничен правами сотрудника в Битрикс24.\n\n## Пример ответа\n\n```json\n{\n  \"success\": true,\n  \"data\": {\n    \"id\": 7689,\n    \"title\": \"Поставка оборудования\",\n    \"amount\": 50000,\n    \"currency\": \"RUB\",\n    \"stageId\": \"NEW\",\n    \"categoryId\": 0,\n    \"assignedById\": 1,\n    \"createdBy\": 1,\n    \"createdAt\": \"2026-04-14T08:43:59.000Z\",\n    \"updatedAt\": \"2026-04-14T08:43:59.000Z\",\n    \"companyId\": 0,\n    \"contactId\": 0,\n    \"opened\": true,\n    \"closed\": \"N\",\n    \"typeId\": \"SALE\",\n    \"observers\": [],\n    \"contactIds\": [],\n    \"entityTypeId\": 2\n  }\n}\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| 403 | `SCOPE_DENIED` | API-ключ не имеет скоупа `crm` |\n| 401 | `TOKEN_MISSING` | API-ключ не имеет настроенных токенов |\n| 400 | `INVALID_REQUEST` | Невалидные поля |\n\nПолный список общих ошибок API — [Ошибки](\u002Fdocs\u002Ferrors).\n\n## Смотрите также\n\n- [Работа с файлами в полях CRM](\u002Fdocs\u002Frecipes\u002Fcrm-files)\n- [Список сделок](\u002Fdocs\u002Fentities\u002Fdeals\u002Flist) — получение с фильтрами\n- [Поля сделки](\u002Fdocs\u002Fentities\u002Fdeals\u002Ffields) — полный список полей\n- [Entity API](\u002Fdocs\u002Fentity-api) — общие принципы (пагинация, select, order)\n- [Синтаксис фильтрации](\u002Fdocs\u002Ffiltering)\n- [Batch](\u002Fdocs\u002Fbatch) — объединение операций\n- [Лимиты и оптимизация](\u002Fdocs\u002Foptimization) — rate limits\n","2026-07-07",{}]