Skip to Content
1MSG
ReferenceCampaigns API

Отправить рассылку или запланировать её

POST
/api/v1/campaigns/{campaignId}/send

Копирует сегмент в снимок отправки. scheduledAt — момент в будущем в ISO-8601 с Z или числовым смещением. Чтобы начать сразу, не передавайте его или передайте null. Отправка шаблонов встаёт на паузу, когда лимит канала за скользящие 24 часа исчерпан. Отдельного поля с лимитом в день нет.

Authorization

bearer
headerAuthorizationBearer <API key>

Ключ выдаётся в Settings → Developer → API key. Методам Inbox нужен доступ Inbox, методам Campaigns — доступ Campaigns.

Path Parameters

campaignId*string

id рассылки из ответа на создание или из списка.

Request Body

application/json
  1. body
scheduledAt?|

Момент в будущем в ISO-8601 с Z или числовым смещением, например 2026-11-01T09:00:00Z. Чтобы начать сразу, не передавайте или передайте null. Поля с лимитом в день нет. Шаблоны отправляются в пределах лимита канала.

Response Body

application/json
  1. response
id*string

id рассылки.

name*string

Название рассылки.

channelId*string

Канал, с которого идёт рассылка.

segmentId*string

Сегмент-аудитория.

status*string

Статус рассылки.

Value in"draft""sending""pause""completed""failed""scheduled"
content*||

Шаблон или текст сессии, сохранённый в рассылке.

sentAt*|

Когда началась отправка, или null, если она ещё не началась.

Formatdate-time
scheduledAt*|

Момент отправки по расписанию в UTC или null.

Formatdate-time
queuedRemaining*number

Получатели, которым ещё не отправили.

sentThisPortion*number

Отправки шаблонов, уже начатые в текущем окне лимита.

dailyLimit*|

Сколько отправок шаблонов этот канал может начать за скользящие 24 часа. Берётся из лимита канала (waba_info.current_limit), а не из настроек рассылки. null, если лимит неизвестен или его нет. Текст сессии не считается.

nextPortionAt*|

Когда может начаться следующая порция шаблонов после того, как окно лимита заполнено. null, если порция не ждёт.

Formatdate-time
createdAt*string

Когда создана рассылка.

Formatdate-time
updatedAt*string

Когда рассылка последний раз менялась.

Formatdate-time
Example Request
curl -X POST 'https://api.1msg.io/api/v1/campaigns/string/send' \  -H 'Content-Type: application/json' \  -d '{}'
Example Response200
{  "id": "cm3campaign01",  "name": "April restock",  "channelId": "cm3channel01",  "segmentId": "cm3segment01",  "status": "draft",  "content": {    "mode": "text",    "text": "Hello"  },  "sentAt": "2026-11-01T09:00:00.000Z",  "scheduledAt": "2026-11-01T09:00:00.000Z",  "queuedRemaining": 0,  "sentThisPortion": 0,  "dailyLimit": 1000,  "nextPortionAt": null,  "createdAt": "2026-11-01T09:00:00.000Z",  "updatedAt": "2026-11-01T09:00:00.000Z"}