Документация

Quickstart

1. 1. Зарегистрируйтесь на sendersy.com
2. 2. Добавьте домен и опубликуйте DKIM / SPF / DMARC записи в DNS
3. 3. Создайте API-ключ в /dashboard/api-keys
4. 4. Отправьте первое письмо:

curl https://api.sendersy.com/v1/emails \
  -H "Authorization: Bearer sk_live_•••" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "Acme <hi@yourcompany.com>",
    "to": "user@example.com",
    "subject": "Welcome",
    "html": "<p>Hi there 👋</p>"
  }'

POST /v1/emails

Resend-совместимый эндпоинт. Возвращает 200 + message_id.

{
  "from": "Acme <noreply@acme.com>",          // required
  "to": ["user@example.com"],                  // string or array
  "cc": ["..."],                               // optional
  "bcc": ["..."],                              // optional
  "subject": "...",                            // required (or use template_id)
  "html": "<p>...</p>",                        // either html or text required
  "text": "...",                               //
  "template_id": "abc-…",                      // OR template_id + variables
  "variables": { "name": "Alex" },             // interpolated into template
  "headers": { "X-Custom": "value" },          // custom headers
  "tags": [{ "name": "category", "value": "welcome" }],
  "scheduled_at": "2026-01-01T10:00:00Z"       // optional ISO 8601
}

Использование шаблонов

Создайте шаблон через Visual builder, ссылайтесь через template_id:

await sendersy.emails.send({
  from: 'Acme <noreply@acme.com>',
  to: user.email,
  template: 'welcome',            // slug шаблона или template_id: '<uuid>'
  variables: {
    name: user.name,
    verify_url: `https://acme.com/verify/${token}`,
  },
})

Поддерживаются {{name}}, {{name|значение по умолчанию}}, {{#if var}}…{{else}}…{{/if}}, {{#unless var}}…{{/unless}} и {{#each items}}…{{/each}}. Переменная {{company}} берётся из фирменного стиля организации. То же работает в POST /v1/emails/batch.

Готовые шаблоны Sendersy

Не хотите верстать письма — укажите готовый шаблон. Он оформляется цветами и логотипом из «Настройки → Фирменный стиль», язык — locale: "ru" или "en". Стиль меняется суффиксом: --minimal, --premium, --gaming, --shop, --saas.

curl -X POST https://api.sendersy.com/v1/emails \
  -H "Authorization: Bearer sk_live_..." -H "Content-Type: application/json" \
  -d '{
    "from": "Acme <noreply@acme.com>",
    "to": "user@example.com",
    "template": "sendersy/otp-code--saas",
    "locale": "ru",
    "variables": { "code": "482915", "expires_in": "10 минут" }
  }'

События и автоматизации

Отправляйте события из своего приложения — они запускают цепочки писем с триггером «событие», выводят контакт из цепочки, если событие назначено целью (например, purchase), и доступны в сегментах («было событие за N дней»). Свойства события подставляются в письма цепочки как {{plan}}.

POST https://api.sendersy.com/v1/events
Authorization: Bearer sk_live_...

{
  "email": "user@example.com",
  "name": "signed_up",              // [A-Za-z0-9_.:-], до 80 символов
  "properties": { "plan": "pro" },  // до 8 КБ
  "first_name": "Анна"              // необязательно
}

→ { "object": "event", "name": "signed_up", "enrolled": 1, "exited": 0 }

Рассылки: время, A/B, язык

Рассылка уходит по 1000 писем в минуту. Можно отправить в одно и то же местное время каждому получателю (поле контакта timezone), протестировать темы на части аудитории — остальным автоматически уйдёт лучшая, и добавить английскую версию для контактов с locale = en. A/B и английская версия настраиваются в редакторе рассылки.

POST https://api.sendersy.com/v1/broadcasts/{id}/send

{ "scheduled_at": "2026-11-01T07:00:00Z" }                          // в определённый момент
{ "local_time": "10:00", "fallback_timezone": "Europe/Moscow" }     // в 10:00 по часам получателя

Новый домен первую неделю отправляет массовые письма с ограничением в час (от 100 до 4000) — так почтовые сервисы привыкают к отправителю. Транзакционные письма через POST /v1/emails не ограничиваются.

Webhooks

Подпишитесь на события в /dashboard/webhooks. Sendersy шлёт POST с подписанным HMAC payload.

// Payload shape
{
  "type": "email.delivered" | "email.opened" | "email.clicked"
        | "email.bounced"   | "email.complained",
  "data": {
    "email_id": "…",
    "from": "noreply@acme.com",
    "to": ["user@example.com"],
    "subject": "Welcome",
    "tags": [...]
  },
  "created_at": "2026-01-01T10:00:00Z"
}

// Headers
X-Sendersy-Signature: t=1735718400,v1=<hex-sha256>
X-Sendersy-Event: email.delivered

Доставляемость

При добавлении домена Sendersy генерирует RSA-2048 DKIM-ключ, готовые TXT-значения SPF/DMARC/MTA-STS/TLS-RPT и хостит MTA-STS endpoint. Вам остаётся опубликовать 5-6 DNS-записей у своего регистратора — мы даём готовые значения для copy-paste и верифицируем в один клик. List-Unsubscribe + One-Click добавляется на каждое письмо. Проверьте свой домен бесплатно: