Рассылки

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

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

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

Path parameters

campaignIdinteger required

ID рассылки.

Headers

Idempotency-Keystring

Опциональный ключ идемпотентности. Если передан, повторные запросы с тем же ключом обрабатываются только один раз.

Request body

Example request

{
  "data": {
    "scheduledStartDate": "2027-03-05T10:00:00.000Z",
    "followUp": {
      "subject": "Did you miss our March update?",
      "offsetHours": 48,
      "previewTitle": "One more chance to catch up"
    },
    "chunkSettings": {
      "initialChunkSize": 1000,
      "increaseChunkSizePercent": 50
    }
  }
}

Response

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

okboolean required

Флаг успешного выполнения.

Example response

{
  "ok": true,
  "data": {
    "id": 1,
    "name": "March newsletter",
    "subject": "Our March update",
    "previewTitle": "Here is what we shipped this month",
    "type": "regular",
    "status": "completed",
    "statusModerate": "approved",
    "attachments": [
      {
        "id": 42,
        "fileName": "price-list.pdf",
        "size": 153204
      }
    ],
    "templateId": 100,
    "senderId": 10,
    "senderEmail": "noreply@example.com",
    "senderName": "Example Team",
    "lists": [
      {
        "id": 1,
        "name": "Newsletter subscribers"
      }
    ],
    "utm": {
      "utm_source": "newsletter",
      "utm_medium": "email",
      "utm_campaign": "march_promo"
    },
    "stats": {
      "total": 1000,
      "sending": {
        "count": 900,
        "rate": 90
      },
      "delivered": {
        "count": 900,
        "rate": 90
      },
      "open": {
        "count": 900,
        "rate": 90
      },
      "click": {
        "count": 900,
        "rate": 90
      },
      "error": {
        "count": 900,
        "rate": 90
      },
      "unsubscribe": {
        "count": 900,
        "rate": 90
      },
      "complaint": {
        "count": 900,
        "rate": 90
      }
    }
  },
  "meta": {
    "requestId": "550e8400-e29b-41d4-a716-446655440000",
    "timestamp": "2026-03-05T12:00:00.000Z",
    "pagination": {
      "page": 1,
      "limit": 20,
      "totalItems": 150,
      "totalPages": 8
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.