---
title: "Отправить письмо из карточки"
method: POST
path: "/api/v1/crm/{entity}/{id}/mail"
tags: ["CRM links"]
---

# Отправить письмо из карточки

`POST /api/v1/crm/{entity}/{id}/mail`

## Request

- Base URL: `https://erp.akeda.ru`
- URL: `https://erp.akeda.ru/api/v1/crm/{entity}/{id}/mail`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://erp.akeda.ru/oauth2/authorize`, token URL `https://erp.akeda.ru/oauth2/token`, scopes: `akeda:delegate`)

Письмо уходит из выбранного ящика модуля «Почта» (account_id — из crmListMailAccounts): встаёт в очередь отправки и появляется в «Отправленных» ящика, а его переписка привязывается к записи; в ленте записи — факт mail_sent. in_reply_to_id — ответ на письмо: уходит в ту же переписку из того же ящика. Нужны адресат и тема или текст — иначе 422 crm.mail_invalid. Письмо уходит внешнему адресату, и после принятия почтовым сервером его не отозвать. Ящик или письмо не видны — 403 crm.mail_not_visible; нет права mail на запись — 403 crm.mail_forbidden; модуль «Почта» не подключён — 409 crm.module_unavailable.

## Request body

- CRMCardMailSendRequest: Письмо из карточки. Нужны адресат и тема или текст
  - `account_id` string, uuid, required
  - `to` string[], required: Адресаты, по одному адресу в строке
  - `cc` string[]: Копия, по одному адресу в строке
  - `subject` string
  - `body_text` string: Текст письма
  - `in_reply_to_id` string, uuid

## Response `201`

Письмо отправлено, переписка привязана

- CRMMailLink: Связь переписки модуля «Почта» с лидом, сделкой или клиентом
  - `id` string, uuid, required
  - `entity_type` 'lead' | 'deal' | 'customer', required
  - `entity_id` string, uuid, required
  - `account_id` string, uuid, required
  - `thread_id` string, uuid, required
  - `message_id` string, uuid, required
  - `source` 'sent' | 'linked' | 'intake', required: sent - письмо отправлено из карточки, linked - сотрудник привязал письмо, intake - письмо пришло в ящик, из которого CRM сама заводит лиды и сделки
  - `linked_by` integer, required
  - `linked_at` string, date-time, required

## Other responses

- `400`: Некорректный запрос или нарушение бизнес-правила
- `401`: Сессия, ключ или кабинет не подтверждены
- `403`: Текущая роль не имеет требуемого права
- `404`: Запись не найдена или не видима текущему пользователю
- `409`: Конфликт версии, идемпотентности или бизнес-состояния
- `422`: Запрос разобран, но бизнес-значение недопустимо
- `503`: Внешний банк, справочник или контур подключений временно недоступен

---

[API](https://skmtc.dev/akeda/apis/akeda-erp-client-api.md) · [All operations](https://skmtc.dev/akeda/apis/akeda-erp-client-api/llms.txt) · [OpenAPI document](https://skmtc.dev/akeda/apis/akeda-erp-client-api/revisions/3c60ded179f2?raw)