Отправка
Отправка писем
Безопасная отправка транзакционных писем, пакетов, ответов, вложений и хранимых шаблонов.
Содержимое письма
Укажите адрес отправителя from на подтверждённом домене рабочего пространства, хотя бы одного получателя to и HTML, текст или один опубликованный хранимый шаблон. При отправке готового содержимого можно не указывать subject — тогда тема будет пустой. При необходимости SendHQ сформирует текстовую версию из HTML, но написанная вручную текстовая версия надёжнее.
Получатели и кредиты
В письме может быть не более 100 адресатов в To, Cc и Bcc в сумме. Каждый адресат расходует один кредит на доставку получателю. Повторяющиеся нормализованные адреса проверяются по стоп-листу один раз, но каждый адресат всё равно учитывается в лимитах письма.
Безопасные повторы
Передавайте стабильный Idempotency-Key длиной не более 200 символов при одиночной и пакетной отправке. Повторное использование ключа с идентичной JSON-нагрузкой воспроизводит сохранённый ответ и добавляет Idempotent-Replayed: true. Если под тем же ключом изменить любого получателя, содержимое, заголовок или данные шаблона, вернётся 409; параллельный запрос с тем же ключом тоже получит 409, пока первый ещё обрабатывается.
Пакетная отправка
POST /emails/batch принимает до 100 объектов писем и возвращает результат для каждой позиции. Для персонализированных данных шаблона используйте отдельные объекты писем, а не отправляйте один персонализированный шаблон нескольким получателям.
Ответы и цепочки
При ответе укажите reply_to_email_id. SendHQ сам определит Message-ID, In-Reply-To, References и ID существующей цепочки. Всю переписку можно получить через GET /threads/:id.