Для AI-агентов: markdown этой страницы — /docs-content/feed/posts/create.md индекс документации — /llms.txt
Создать пост
POST /v1/posts
Публикует пост в Ленте новостей Битрикс24 и возвращает его идентификатор. Текст поддерживает BB-код для оформления.
Опрос к посту через API не добавляется.
Поля запроса (body)
| Поле | Тип | Обяз. | По умолч. | Описание |
|---|---|---|---|---|
Полеtext |
Типstring | Обяз.да | По умолч.— | ОписаниеТекст поста. Поддерживает BB-код: [b], [i], [url] и другие теги оформления |
Полеtitle |
Типstring | Обяз.нет | По умолч.— | ОписаниеЗаголовок поста |
Полеrecipients |
Типstring[] | Обяз.да | По умолч.— | ОписаниеКто увидит пост. Префиксы:UA — все сотрудники портала, только без других получателей,U<id> — сотрудник (GET /v1/users),D<id> — отдел без подотделов,DR<id> — отдел с подотделами (GET /v1/departments),SG<id> — рабочая группа или проект (GET /v1/workgroups).ID — положительное целое без начальных нулей. Не более 100 различных получателей и 1000 элементов массива. Пустой массив или пропуск запрещён |
Полеfiles |
Типarray | Обяз.нет | По умолч.— | ОписаниеФайлы для прикрепления к посту. Каждый элемент — пара ["имя_файла", "<содержимое в base64>"]. Файл загружается на Диск автора и привязывается к посту.Пример: [["smeta.pdf", "JVBERi0xLjQ…"]] |
Примеры
curl — личный ключ
curl -X POST https://vibecode.bitrix24.tech/v1/posts \
-H "X-Api-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"title": "Релиз новой версии",
"text": "Сегодня вышло обновление. [b]Подробности[/b] — в комментариях.",
"recipients": ["U1"]
}'
curl — OAuth-приложение
curl -X POST https://vibecode.bitrix24.tech/v1/posts \
-H "X-Api-Key: YOUR_APP_KEY" \
-H "Authorization: Bearer USER_SESSION_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"title": "Релиз новой версии",
"text": "Сегодня вышло обновление. [b]Подробности[/b] — в комментариях.",
"recipients": ["U1"]
}'
JavaScript — личный ключ
const res = await fetch('https://vibecode.bitrix24.tech/v1/posts', {
method: 'POST',
headers: {
'X-Api-Key': 'YOUR_API_KEY',
'Content-Type': 'application/json',
},
body: JSON.stringify({
title: 'Релиз новой версии',
text: 'Сегодня вышло обновление. [b]Подробности[/b] — в комментариях.',
recipients: ['U1'],
}),
})
const { success, data } = await res.json()
console.log('Post ID:', data.id)
JavaScript — OAuth-приложение
const res = await fetch('https://vibecode.bitrix24.tech/v1/posts', {
method: 'POST',
headers: {
'X-Api-Key': 'YOUR_APP_KEY',
'Authorization': 'Bearer USER_SESSION_TOKEN',
'Content-Type': 'application/json',
},
body: JSON.stringify({
title: 'Релиз новой версии',
text: 'Сегодня вышло обновление. [b]Подробности[/b] — в комментариях.',
recipients: ['U1'],
}),
})
const { success, data } = await res.json()
Поля ответа
| Поле | Тип | Описание |
|---|---|---|
Полеsuccess |
Типboolean | ОписаниеВсегда true при успехе |
Полеdata |
Типobject | ОписаниеСозданный пост |
Полеdata.id |
Типnumber | ОписаниеИдентификатор созданного поста. Адрес поста на портале: https://<portal>.bitrix24.ru/company/personal/user/<authorId>/blog/<id>/, где authorId — поле authorId из ответа GET /v1/posts |
Полеdata.recipients |
Типstring[] | ОписаниеЯвно переданные получатели, которым открыт пост, в исходном порядке |
Пример ответа
{
"success": true,
"data": {
"id": 303,
"recipients": ["U1"]
}
}
Пример ответа при ошибке
400 — не передан text:
{
"success": false,
"error": {
"code": "MISSING_PARAMS",
"message": "Required: text (string — post content)"
}
}
Ошибки
| HTTP | Код | Описание |
|---|---|---|
| HTTP400 | КодMISSING_PARAMS |
ОписаниеНе передан text, либо recipients пропущен или содержит пустой массив |
| HTTP400 | КодINVALID_PARAMS |
ОписаниеНеверный тип или код получателя, UA вместе с другими получателями либо превышен лимит аудитории |
| HTTP403 | КодSCOPE_DENIED |
ОписаниеУ API-ключа нет скоупа log |
| HTTP401 | КодTOKEN_MISSING |
ОписаниеУ API-ключа не настроены токены доступа |
| HTTP422 | КодBITRIX_ERROR |
ОписаниеБитрикс24 отклонил создание поста (текст ошибки в message) |
| HTTP502 | КодBITRIX_UNAVAILABLE |
ОписаниеБитрикс24 недоступен |
Полный список общих ошибок API — Ошибки.