---
title: "Запустить рассылку"
method: POST
path: "/v1/public/campaigns/{campaignId}/schedule"
tags: ["Рассылки"]
---

# Запустить рассылку

`POST /v1/public/campaigns/{campaignId}/schedule`

## Request

- Base URL: `https://api.rusender.ru/api`
- URL: `https://api.rusender.ru/api/v1/public/campaigns/{campaignId}/schedule`
- Auth: HTTP bearer

Запускает черновик рассылки: рассылка уходит на модерацию и отправляется сразу после одобрения либо в заданное время (scheduledStartDate), если оно передано. У черновика уже должны быть шаблон, отправитель, тема и хотя бы один список контактов (задаются при создании/редактировании); у A/B-рассылки также должен быть задан abTest.percent. Для обычных рассылок доступны две опциональные взаимоисключающие опции запуска: followUp — досыл письма с другой темой контактам, которые не открыли рассылку; chunkSettings — отправка ежедневными частями растущего размера. Для A/B-рассылок эти опции недоступны.

## Path parameters

- `campaignId` integer, required

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `data` object, required: Основные данные запроса.
    - `scheduledStartDate` string: Отложенное время старта (ISO 8601). Не может быть в прошлом. Если не задано — рассылка отправляется сразу.
    - `followUp` ScheduleCampaignFollowUpDto
      - `subject` string, required: Тема письма досыла.
      - `offsetHours` number, required: Задержка в часах после завершения рассылки перед отправкой досыла (минимум 24).
      - `previewTitle` string: Прехедер письма досыла.
    - `chunkSettings` ScheduleCampaignChunkSettingsDto
      - `initialChunkSize` number, required: Количество получателей в первом чанке (минимум 1).
      - `increaseChunkSizePercent` number: Процент роста размера каждого следующего чанка (минимум 0).
  - `meta` PublicApiRequestMetaDto
    - `requestId` string: Client-provided request ID для корреляции.

## Response `200`

Запущенная рассылка.

- object
  - `ok` boolean, required: Флаг успешного выполнения.
  - `data` object, required: Полезная нагрузка успешного ответа.
    - `id` number, required: Идентификатор рассылки.
    - `name` string, required: Название рассылки.
    - `subject` string: Тема письма.
    - `previewTitle` string: Preview-текст письма.
    - `type` 'regular' | 'ab_basic' | 'ab_variant' | 'follow_up_basic' | 'follow_up' | 'chunked', required: Тип рассылки.
    - `status` 'draft' | 'built' | 'scheduled' | 'in_progress' | 'paused' | 'completed' | 'banned' | 'on_hold', required: Статус рассылки.
    - `statusModerate` 'not_ready_to_moderate' | 'ready_to_moderate' | 'moderating' | 'approved' | 'banned' | 'paused', required: Статус модерации рассылки.
    - `folderId` object: ID папки, в которой лежит рассылка. null — если не в папке.
    - `isArchived` boolean, required: Находится ли рассылка в архиве.
    - `dashboardUrl` string, required: Прямая ссылка на рассылку в дашборде
    - `attachments` CampaignAttachmentDto[], required: Вложения письма рассылки.
      - `id` number, required: Идентификатор вложения.
      - `fileName` string, required: Имя файла вложения.
      - `size` number, required: Размер файла в байтах.
    - `templateId` number: ID шаблона, используемого в рассылке.
    - `senderId` number: ID email-отправителя.
    - `senderEmail` string: Email адрес отправителя.
    - `senderName` string: Имя отправителя.
    - `lists` CampaignListReferenceDto[], required: Списки контактов, на которые идёт рассылка.
      - `id` number, required: ID списка контактов.
      - `name` string, required: Название списка контактов.
    - `utm` CampaignUtmDto
      - `utm_source` string: Query-параметр utm_source, добавляемый ко всем ссылкам письма (источник трафика, например «newsletter»).
      - `utm_medium` string: Query-параметр utm_medium, добавляемый ко всем ссылкам письма (канал трафика, например «email»).
      - `utm_campaign` string: Query-параметр utm_campaign, добавляемый ко всем ссылкам письма (идентификатор кампании).
    - `scheduledAt` object: Запланированное время старта рассылки (ISO 8601).
    - `startedAt` object: Фактическое время начала рассылки (ISO 8601).
    - `finishedAt` object: Время завершения рассылки (ISO 8601).
    - `createdAt` object: Время создания рассылки (ISO 8601).
    - `updatedAt` object: Время последнего обновления рассылки (ISO 8601).
    - `stats` CampaignStatsDto
      - `total` number, required: Общее количество адресов в рассылке.
      - `sending` CampaignStatMetricDto, required
        - `count` number, required: Абсолютное количество.
        - `rate` number, required: Значение в процентах.
      - `delivered` CampaignStatMetricDto, required
        - `count` number, required: Абсолютное количество.
        - `rate` number, required: Значение в процентах.
      - `open` CampaignStatMetricDto, required
        - `count` number, required: Абсолютное количество.
        - `rate` number, required: Значение в процентах.
      - `click` CampaignStatMetricDto, required
        - `count` number, required: Абсолютное количество.
        - `rate` number, required: Значение в процентах.
      - `error` CampaignStatMetricDto, required
        - `count` number, required: Абсолютное количество.
        - `rate` number, required: Значение в процентах.
      - `unsubscribe` CampaignStatMetricDto, required
        - `count` number, required: Абсолютное количество.
        - `rate` number, required: Значение в процентах.
      - `complaint` CampaignStatMetricDto, required
        - `count` number, required: Абсолютное количество.
        - `rate` number, required: Значение в процентах.
  - `meta` PublicApiResponseMetaDto, required
    - `requestId` string, required: Итоговый идентификатор запроса, использованный сервером.
    - `timestamp` string, required: Время формирования ответа в формате ISO-8601.
    - `pagination` PublicApiPaginationMetaDto
      - `page` number, required: Текущая страница.
      - `limit` number, required: Количество элементов на странице.
      - `totalItems` number, required: Общее количество элементов.
      - `totalPages` number, required: Общее количество страниц.

## Other responses

- `400`: Некорректный запрос.
- `401`: Требуется валидный токен Public API.
- `403`: Для вызова endpoint не хватает требуемого scope.
- `404`: Запрошенный ресурс не найден.
- `422`: Рассылку нельзя запустить: рассылка не в статусе DRAFT либо не заданы шаблон, отправитель, тема или списки.
- `429`: Превышен rate limit для текущего API key.
- `500`: Внутренняя ошибка сервера.

---

[API](https://skmtc.dev/rusender/apis/public-api.md) · [All operations](https://skmtc.dev/rusender/apis/public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/rusender/apis/public-api/revisions/8e86bca789ea?raw)