---
title: "Создание письма"
method: POST
path: "/emails"
tags: ["Email"]
---

# Создание письма

`POST /emails`

Создает письмо и ставит его в очередь отправки. Поддерживает идемпотентность через заголовок `Idempotency-Key`.

## Headers

- `Idempotency-Key` string, uuid

## Request body

- EmailCreateRequest
  - `from_name` string, required — Имя отправителя.
  - `from_email` string, email, required — Email отправителя.
  - `email` string, email, required — Email получателя.
  - `subject` string, required — Тема письма.
  - `message` string, required — HTML-тело письма. Если плейсхолдер `{{UnsubscribeUrl}}` не передан, ссылка отписки добавляется автоматически.
  - `tags` string[] — Уникальные slug-метки.

## Response `200`

Письмо создано.

- object
  - `uuid` string, uuid, required — UUID в стандартном строковом формате.

## Other responses

- `400` — Неправильный запрос.
- `401` — Пользователь не авторизован или токен не передан.
- `403` — Доступ запрещен.
- `500` — Внутренняя ошибка сервера.

---

[API](https://skmtc.dev/smartofood/apis/smartofood-control-api.md) · [All operations](https://skmtc.dev/smartofood/apis/smartofood-control-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/smartofood/smartofood-control-api/revisions/50489dff6853/schema)