---
title: "Письма карточки лида, сделки или клиента"
method: GET
path: "/api/v1/crm/{entity}/{id}/mail"
tags: ["CRM links"]
---

# Письма карточки лида, сделки или клиента

`GET /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`)

Переписки, привязанные к записи: отправленные из карточки (source=sent — ответы клиента в той же переписке попадают сами) и привязанные сотрудником (linked), свежие сверху. CRM письма не копирует: тему и письма каждый раз читает почта с правами того, кто смотрит. Переписка из ящика, которого он не видит, приходит с visible=false, без темы и писем. addresses — адреса почты клиента записи, ими заполняют «Кому». Нужны право видеть запись и право mail на чтение — без него 403 crm.mail_forbidden; модуль «Почта» не подключён — 409 crm.module_unavailable.

## Response `200`

Переписки карточки и адреса клиента

- CRMCardMailList: Переписки карточки, свежие сверху, и адреса почты клиента
  - `items` CRMCardMailThread[], required
    - `link_id` string, uuid, required
    - `thread_id` string, uuid, required
    - `source` 'sent' | 'linked' | 'intake', required: sent - письмо отправлено из карточки, linked - сотрудник привязал письмо, intake - письмо пришло в ящик, из которого CRM сама заводит лиды и сделки
    - `linked_by` integer, required
    - `linked_at` string, date-time, required
    - `visible` boolean, required: Видит ли смотрящий ящик этой переписки
    - `subject` string
    - `messages` CRMMailMessage[]: Письма переписки от старых к новым
      - `id` string, uuid, required
      - `thread_id` string, uuid, required
      - `account_id` string, uuid, required
      - `subject` string, required
      - `from_address` string, required
      - `from_name` string, required
      - `to` string[], required: Адреса получателей и копии
      - `snippet` string, required: Начало текста письма
      - `direction` 'inbound' | 'outbound', required: inbound - пришло в ящик, outbound - ушло из него
      - `at` string, date-time, required: Когда письмо отправлено или получено
      - `is_read` boolean, required
  - `addresses` string[], required: Адреса почты клиента записи без повторов, в нижнем регистре

## Other responses

- `400`: Некорректный запрос или нарушение бизнес-правила
- `401`: Сессия, ключ или кабинет не подтверждены
- `403`: Текущая роль не имеет требуемого права
- `404`: Запись не найдена или не видима текущему пользователю
- `409`: Конфликт версии, идемпотентности или бизнес-состояния
- `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/a99574d597cc?raw)