REST API

REST API

Отправляйте одним JSON-запросом. Ключи идемпотентности предотвращают дубликаты.

Основные ресурсы

POST /v1/emails — поставить сообщение в очередь GET /v1/emails/{id} — статус сообщения

Модель ответа

202 означает «поставлено в очередь», а не «доставлено во входящие». 403 указывает на отсутствие scope или неверифицированный домен. 422 блокирует suppressed-получателя. 429 — превышен лимит запросов.

Актуальная модель доступа

Текущие ключи dashboard используют префикс srs_live_. До проверки клиентского From-домена общий sandbox-отправитель может писать только участникам проекта. После проверки DNS внешняя отправка ограничивается квотами тарифа, suppression, лимитами получателей и abuse-контролями. Ответ 202 означает очередь, а не доставку.

Материалы для интеграции

Используйте пошаговое руководство для людей и AI-агентов, а OpenAPI — как источник истины по полям API.

POST /v1/emails
POST /v1/emails
Authorization: Bearer srs_live_...
Idempotency-Key: reset-4821
Content-Type: application/json

{
  "from": "Sender Name <info@example.com>",
  "to": ["user@example.net"],
  "subject": "Reset your password",
  "html": "<p>Click to reset your password.</p>"
}