[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"docs-entities\u002Fpages\u002Fcreate":3,"docs-tabs-entities\u002Fpages\u002Fcreate":6},{"content":4,"lastmod":5},"\n## Создать страницу\n\n`POST \u002Fv1\u002Fpages`\n\nСоздаёт новую страницу на указанном сайте. Поля передаются плоско в корне JSON — без обёртки `fields`. Минимум для создания: `title` + `siteId`. Новая страница создаётся неактивной — `active: false`. Активировать её можно в интерфейсе портала Битрикс24, в разделе «Сайты».\n\n## Поля запроса (body)\n\n| Поле | Тип | Обяз. | Описание |\n|------|-----|:-----:|---------|\n| `title` | string | да | Название страницы, до 255 символов |\n| `siteId` | number | да | Идентификатор сайта. Источник: [`GET \u002Fv1\u002Fsites`](\u002Fdocs\u002Fentities\u002Fsites\u002Flist) |\n| `code` | string | нет | Символьный код страницы в URL. Не должен содержать `\u002F`. Если оставить пустым или не передать — генерируется из `title`. Если код уже занят на сайте — добавляется числовой суффикс |\n| `description` | string | нет | Произвольное описание страницы |\n| `public` | string | нет | Публичность — `Y` \u002F `N` |\n| `sitemap` | string | нет | Включить в карту сайта — `Y` \u002F `N` |\n| `xmlId` | string | нет | Внешний код |\n| `folderId` | number | нет | ID папки-раздела сайта |\n| `tplId` | number | нет | ID шаблона |\n\n> Полный перечень полей — [`GET \u002Fv1\u002Fpages\u002Ffields`](.\u002Ffields.md): эндпоинт возвращает карту всех полей с типом и признаком `readonly`. Записывать можно поля, у которых `readonly` отсутствует. Перечисленные выше дополнительные поля применяются при создании наравне с `title`\u002F`siteId`\u002F`code`\u002F`description`.\n\n## Примеры\n\n### curl — личный ключ\n\n```bash\ncurl -X POST \"https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fpages\" \\\n  -H \"X-Api-Key: YOUR_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"title\": \"Весенняя акция\",\n    \"code\": \"spring-sale\",\n    \"siteId\": 3,\n    \"description\": \"Лендинг сезонной акции на скидки\"\n  }'\n```\n\n### curl — OAuth-приложение\n\n```bash\ncurl -X POST \"https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fpages\" \\\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    \"code\": \"spring-sale\",\n    \"siteId\": 3,\n    \"description\": \"Лендинг сезонной акции на скидки\"\n  }'\n```\n\n### JavaScript — личный ключ\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fpages', {\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    code: 'spring-sale',\n    siteId: 3,\n    description: 'Лендинг сезонной акции на скидки',\n  }),\n})\n\nconst { success, data } = await res.json()\nconsole.log('Page ID:', data.id)\n```\n\n### JavaScript — OAuth-приложение\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fpages', {\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    code: 'spring-sale',\n    siteId: 3,\n    description: 'Лендинг сезонной акции на скидки',\n  }),\n})\n\nconst { success, data } = await res.json()\n```\n\n## Поля ответа\n\nВозвращается полный объект созданной страницы.\n\n| Поле | Тип | Описание |\n|------|-----|---------|\n| `id` | number | Идентификатор созданной страницы |\n| `title` | string | Название страницы |\n| `code` | string | Фактический символьный код (с авто-суффиксом, если код запроса был занят) |\n| `siteId` | number | Идентификатор сайта |\n| `active` | boolean | Всегда `false` для только что созданной страницы |\n| `description` | string \\| null | Описание страницы |\n| `createdById` | number | Идентификатор создавшего сотрудника |\n| `dateCreate` | datetime | Дата создания |\n| `dateModify` | datetime | Дата последнего изменения |\n\nURL страницы в Битрикс24 строится из `id` и `siteId`:\n\n```\nhttps:\u002F\u002F\u003Cportal>.bitrix24.ru\u002Fsites\u002Fsite\u002F\u003CsiteId>\u002Fview\u002F\u003Cid>\u002F\n```\n\n`\u003CsiteId>` — ID сайта, которому принадлежит страница (поле `siteId` в ответе). `\u003Cportal>` — домен портала. Доступ ограничен правами сотрудника в Битрикс24.\n\n## Пример ответа\n\n```json\n{\n  \"success\": true,\n  \"data\": {\n    \"id\": 2295,\n    \"title\": \"Весенняя акция\",\n    \"code\": \"spring-sale\",\n    \"siteId\": 3,\n    \"active\": false,\n    \"description\": \"Лендинг сезонной акции на скидки\",\n    \"createdById\": 1,\n    \"dateCreate\": \"08.05.2026 11:49:33\",\n    \"dateModify\": \"08.05.2026 11:49:33\"\n  }\n}\n```\n\n## Пример ответа при ошибке\n\n422 — не передано обязательное поле `title`:\n\n```json\n{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"BITRIX_ERROR\",\n    \"message\": \"Не заполнено обязательное поле «Название страницы»\"\n  }\n}\n```\n\n## Ошибки\n\n| HTTP | `error.code` | Маркер в `error.message` | Описание |\n|------|--------------|--------------------------|---------|\n| 422 | `BITRIX_ERROR` | `Не заполнено обязательное поле` | Пропущено `title` или `siteId` |\n| 422 | `BITRIX_ERROR` | `Слеш запрещен в адресе лендинга` | В `code` передан символ `\u002F` — слеши в коде запрещены |\n| 422 | `BITRIX_ERROR` | `Адрес страницы не может быть пустым` | В `code` передана пустая строка без указания, что создаётся папка |\n| 422 | `BITRIX_ERROR` | `Недопустимый адрес страницы` | В `code` передано значение в формате `__`, например `code_12_34` |\n| 404 | `ENTITY_NOT_FOUND` | `Сайт не найден` | В `siteId` передан несуществующий идентификатор сайта |\n| 403 | `BITRIX_ACCESS_DENIED` | — | У пользователя нет права «редактирование» для указанного сайта |\n| 403 | `SCOPE_DENIED` | — | API-ключ не имеет скоупа `landing` |\n| 401 | `TOKEN_MISSING` | — | API-ключ не имеет настроенных токенов |\n\nПолный список общих ошибок API — [Ошибки](\u002Fdocs\u002Ferrors).\n\n## Смотрите также\n\n- [Список страниц](\u002Fdocs\u002Fentities\u002Fpages\u002Flist) — посмотреть существующие страницы перед созданием\n- [Получить страницу](\u002Fdocs\u002Fentities\u002Fpages\u002Fget) — данные созданной страницы по ID\n- [Обновить страницу](\u002Fdocs\u002Fentities\u002Fpages\u002Fupdate) — изменить параметры созданной страницы\n- [Удалить страницу](\u002Fdocs\u002Fentities\u002Fpages\u002Fdelete) — удалить страницу\n- [Сайты](\u002Fdocs\u002Fentities\u002Fsites) — родительские контейнеры страниц\n- [Batch](\u002Fdocs\u002Fbatch) — массовое создание\n- [Лимиты и оптимизация](\u002Fdocs\u002Foptimization) — rate limits\n","2026-07-07",{}]