[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"docs-mail\u002Fmailboxes":3,"docs-tabs-mail\u002Fmailboxes":6},{"content":4,"lastmod":5},"\n# Почтовые ящики\n\nСписок почтовых ящиков портала и получение сведений об отдельном ящике и его адресах отправителей.\n\nБитрикс24 API: `mail.mailbox.*`\nСкоуп: `mail`\n\n## Операции\n\n- [Список ящиков](.\u002Fmailboxes\u002Flist.md) — `GET \u002Fv1\u002Fmail\u002Fmailboxes`\n- [Получить ящик](.\u002Fmailboxes\u002Fget.md) — `GET \u002Fv1\u002Fmail\u002Fmailboxes\u002F:id`\n- [Адреса отправителя](.\u002Fmailboxes\u002Fsenders.md) — `GET \u002Fv1\u002Fmail\u002Fmailboxes\u002F:id\u002Fsenders`\n\n## Смотрите также\n\n- [Почта](\u002Fdocs\u002Fmail)\n","2026-06-23",{"mailboxes\u002Flist.md":7,"mailboxes\u002Fget.md":8,"mailboxes\u002Fsenders.md":9},"\n## Список почтовых ящиков\n\n`GET \u002Fv1\u002Fmail\u002Fmailboxes`\n\nВозвращает список почтовых ящиков, подключённых к порталу.\n\n## Параметры\n\n| Параметр | В | Тип | Обяз. | По умолч. | Описание |\n|----------|---|-----|:-----:|-----------|----------|\n| `limit` | query | number | нет | `50` | Количество записей на страницу (максимум `500`) |\n| `offset` | query | number | нет | `0` | Смещение от начала списка |\n\n## Примеры\n\n### curl — личный ключ\n\n```bash\ncurl \"https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fmail\u002Fmailboxes\" \\\n  -H \"X-Api-Key: YOUR_API_KEY\"\n```\n\n### curl — OAuth-приложение\n\n```bash\ncurl \"https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fmail\u002Fmailboxes\" \\\n  -H \"X-Api-Key: YOUR_APP_KEY\" \\\n  -H \"Authorization: Bearer USER_SESSION_TOKEN\"\n```\n\n### JavaScript — личный ключ\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fmail\u002Fmailboxes', {\n  headers: { 'X-Api-Key': 'YOUR_API_KEY' },\n})\nconst { success, data, meta } = await res.json()\nconsole.log(`Почтовых ящиков: ${meta.total}`)\n```\n\n### JavaScript — OAuth-приложение\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fmail\u002Fmailboxes', {\n  headers: {\n    'X-Api-Key': 'YOUR_APP_KEY',\n    'Authorization': 'Bearer USER_SESSION_TOKEN',\n  },\n})\nconst { success, data, meta } = await res.json()\n```\n\n## Поля ответа\n\n| Поле | Тип | Описание |\n|------|-----|----------|\n| `success` | boolean | Всегда `true` при успехе |\n| `data` | array | Массив почтовых ящиков |\n| `data[].id` | number | Идентификатор ящика |\n| `data[].name` | string | Отображаемое имя ящика |\n| `data[].email` | string | Адрес электронной почты ящика |\n| `data[].senderName` | string | Имя отправителя, подставляемое в поле «От» |\n| `meta.total` | number | Общее количество ящиков на портале |\n| `meta.hasMore` | boolean | Есть ли ещё записи за пределами `limit` |\n\nURL любого ящика из массива `data` — его `id`:\n\n```\nhttps:\u002F\u002F\u003Cportal>.bitrix24.ru\u002Fmail\u002Flist\u002F\u003Cid>\u002F\n```\n\n`\u003Cportal>` — домен портала. Доступ ограничен правами сотрудника в Битрикс24.\n\n## Пример ответа\n\n```json\n{\n  \"success\": true,\n  \"data\": [\n    {\n      \"id\": 1,\n      \"name\": \"Рабочая почта\",\n      \"email\": \"info@example.com\",\n      \"senderName\": \"Компания\"\n    },\n    {\n      \"id\": 2,\n      \"name\": \"Поддержка\",\n      \"email\": \"support@example.com\",\n      \"senderName\": \"Служба поддержки\"\n    }\n  ],\n  \"meta\": {\n    \"total\": 2,\n    \"hasMore\": false\n  }\n}\n```\n\n## Пример ответа при ошибке\n\n403 — нет скоупа `mail`:\n\n```json\n{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"SCOPE_DENIED\",\n    \"message\": \"This endpoint requires 'mail' scope\"\n  }\n}\n```\n\n## Ошибки\n\n| HTTP | Код | Описание |\n|------|-----|----------|\n| 403 | `SCOPE_DENIED` | API-ключ не имеет скоупа `mail` |\n| 401 | `TOKEN_MISSING` | API-ключ не имеет настроенных токенов |\n| 429 | `RATE_LIMITED` | Превышен лимит запросов |\n| 502 | `BITRIX_UNAVAILABLE` | Портал Битрикс24 недоступен |\n| 422 | `BITRIX_ERROR` | Битрикс24 вернул ошибку |\n\nПолный список общих ошибок API — [Ошибки](\u002Fdocs\u002Ferrors).\n\n## Известные особенности\n\n- Список приходит массивом в `data` с пагинацией в `meta` (`total`, `hasMore`); в `GET \u002Fv1\u002Fmail\u002Fmessages` письма возвращаются иначе — в `data.items`.\n\n## Смотрите также\n\n- [Получить почтовый ящик](.\u002Fget.md)\n- [Адреса отправителя ящика](.\u002Fsenders.md)\n","\n## Получить почтовый ящик\n\n`GET \u002Fv1\u002Fmail\u002Fmailboxes\u002F:id`\n\nВозвращает данные одного почтового ящика по его идентификатору.\n\n## Параметры\n\n| Параметр | В | Тип | Обяз. | По умолч. | Описание |\n|----------|---|-----|:-----:|-----------|----------|\n| `id` | path | number | да | — | Идентификатор почтового ящика (из [списка ящиков](.\u002Flist.md)) |\n\n## Примеры\n\n### curl — личный ключ\n\n```bash\ncurl \"https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fmail\u002Fmailboxes\u002F1\" \\\n  -H \"X-Api-Key: YOUR_API_KEY\"\n```\n\n### curl — OAuth-приложение\n\n```bash\ncurl \"https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fmail\u002Fmailboxes\u002F1\" \\\n  -H \"X-Api-Key: YOUR_APP_KEY\" \\\n  -H \"Authorization: Bearer USER_SESSION_TOKEN\"\n```\n\n### JavaScript — личный ключ\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fmail\u002Fmailboxes\u002F1', {\n  headers: { 'X-Api-Key': 'YOUR_API_KEY' },\n})\nconst { success, data } = await res.json()\nconsole.log(data.email)\n```\n\n### JavaScript — OAuth-приложение\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fmail\u002Fmailboxes\u002F1', {\n  headers: {\n    'X-Api-Key': 'YOUR_APP_KEY',\n    'Authorization': 'Bearer USER_SESSION_TOKEN',\n  },\n})\nconst { success, data } = await res.json()\n```\n\n## Поля ответа\n\n| Поле | Тип | Описание |\n|------|-----|----------|\n| `success` | boolean | Всегда `true` при успехе |\n| `data.id` | number | Идентификатор ящика |\n| `data.name` | string | Отображаемое имя ящика |\n| `data.email` | string | Адрес электронной почты ящика |\n| `data.senderName` | string | Имя отправителя, подставляемое в поле «От» |\n\n## Пример ответа\n\n```json\n{\n  \"success\": true,\n  \"data\": {\n    \"id\": 1,\n    \"name\": \"Рабочая почта\",\n    \"email\": \"info@example.com\",\n    \"senderName\": \"Компания\"\n  }\n}\n```\n\n## Пример ответа при ошибке\n\n404 — ящик не найден:\n\n```json\n{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"ENTITY_NOT_FOUND\",\n    \"message\": \"Запись с ID = `42` не найдена\"\n  }\n}\n```\n\n## Ошибки\n\n| HTTP | Код | Описание |\n|------|-----|----------|\n| 404 | `ENTITY_NOT_FOUND` | Ящик с указанным ID не найден |\n| 403 | `SCOPE_DENIED` | API-ключ не имеет скоупа `mail` |\n| 401 | `TOKEN_MISSING` | API-ключ не имеет настроенных токенов |\n| 429 | `RATE_LIMITED` | Превышен лимит запросов |\n| 502 | `BITRIX_UNAVAILABLE` | Портал Битрикс24 недоступен |\n| 422 | `BITRIX_ERROR` | Битрикс24 вернул ошибку |\n\nПолный список общих ошибок API — [Ошибки](\u002Fdocs\u002Ferrors).\n\n## Известные особенности\n\n**Нечисловой ID.** Нечисловые значения вроде `abc` уходят в Битрикс24 с `id=0` и возвращают `404 ENTITY_NOT_FOUND`, а не ошибку валидации.\n\n## Смотрите также\n\n- [Список почтовых ящиков](.\u002Flist.md)\n- [Адреса отправителя ящика](.\u002Fsenders.md)\n","\n## Адреса отправителя ящика\n\n`GET \u002Fv1\u002Fmail\u002Fmailboxes\u002F:id\u002Fsenders`\n\nВозвращает список адресов, от имени которых можно отправлять письма из указанного почтового ящика.\n\n## Параметры\n\n| Параметр | В | Тип | Обяз. | По умолч. | Описание |\n|----------|---|-----|:-----:|-----------|----------|\n| `id` | path | number | да | — | Идентификатор почтового ящика (из [списка ящиков](.\u002Flist.md)) |\n\n## Примеры\n\n### curl — личный ключ\n\n```bash\ncurl \"https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fmail\u002Fmailboxes\u002F1\u002Fsenders\" \\\n  -H \"X-Api-Key: YOUR_API_KEY\"\n```\n\n### curl — OAuth-приложение\n\n```bash\ncurl \"https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fmail\u002Fmailboxes\u002F1\u002Fsenders\" \\\n  -H \"X-Api-Key: YOUR_APP_KEY\" \\\n  -H \"Authorization: Bearer USER_SESSION_TOKEN\"\n```\n\n### JavaScript — личный ключ\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fmail\u002Fmailboxes\u002F1\u002Fsenders', {\n  headers: { 'X-Api-Key': 'YOUR_API_KEY' },\n})\nconst { success, data } = await res.json()\nconsole.log(data.items)\n```\n\n### JavaScript — OAuth-приложение\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fmail\u002Fmailboxes\u002F1\u002Fsenders', {\n  headers: {\n    'X-Api-Key': 'YOUR_APP_KEY',\n    'Authorization': 'Bearer USER_SESSION_TOKEN',\n  },\n})\nconst { success, data } = await res.json()\n```\n\n## Поля ответа\n\n| Поле | Тип | Описание |\n|------|-----|----------|\n| `success` | boolean | Всегда `true` при успехе |\n| `data.items` | array | Список адресов отправителя |\n| `data.items[].email` | string | Адрес электронной почты отправителя |\n| `data.items[].name` | string | Отображаемое имя отправителя |\n| `data.items[].sender` | string | Строка для заголовка `From` в формате `\"Имя \u003Cemail>\"` |\n\n## Пример ответа\n\n```json\n{\n  \"success\": true,\n  \"data\": {\n    \"items\": [\n      {\n        \"email\": \"info@example.com\",\n        \"name\": \"Рабочая почта\",\n        \"sender\": \"Компания \u003Cinfo@example.com>\"\n      },\n      {\n        \"email\": \"support@example.com\",\n        \"name\": \"Поддержка\",\n        \"sender\": \"Служба поддержки \u003Csupport@example.com>\"\n      },\n      {\n        \"email\": \"sales@example.com\",\n        \"name\": \"Отдел продаж\",\n        \"sender\": \"Отдел продаж \u003Csales@example.com>\"\n      }\n    ]\n  }\n}\n```\n\n## Пример ответа при ошибке\n\n400 — нечисловой ID:\n\n```json\n{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"INVALID_PARAMS\",\n    \"message\": \"id must be a positive integer\"\n  }\n}\n```\n\n## Ошибки\n\n| HTTP | Код | Описание |\n|------|-----|----------|\n| 400 | `INVALID_PARAMS` | `id` не является положительным целым числом |\n| 403 | `SCOPE_DENIED` | API-ключ не имеет скоупа `mail` |\n| 401 | `TOKEN_MISSING` | API-ключ не имеет настроенных токенов |\n| 429 | `RATE_LIMITED` | Превышен лимит запросов |\n| 502 | `BITRIX_UNAVAILABLE` | Портал Битрикс24 недоступен |\n| 422 | `BITRIX_ERROR` | Битрикс24 вернул ошибку |\n\nПолный список общих ошибок API — [Ошибки](\u002Fdocs\u002Ferrors).\n\n## Известные особенности\n\n**Адреса для отправки.** Вызывайте этот эндпоинт перед составлением письма, чтобы получить список допустимых адресов отправителя и дать пользователю выбрать нужный.\n\n## Смотрите также\n\n- [Список почтовых ящиков](.\u002Flist.md)\n- [Получить почтовый ящик](.\u002Fget.md)\n"]