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

# Привязать письмо к карточке

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

## Request

- Base URL: `https://erp.akeda.ru`
- URL: `https://erp.akeda.ru/api/v1/crm/{entity}/{id}/mail/links`
- 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`)

Привязывает к записи всю переписку письма message_id, которое человек видит в почте (подходящие — crmListCardMailCandidates); в ленте записи — факт mail_linked, дальнейшие письма этой переписки тоже видны в карточке. Уже привязанная переписка возвращает прежнюю связь. Письмо или ящик не видны — 403 crm.mail_not_visible; письма нет — 404. Нужны право изменять запись и право mail на чтение — без него 403 crm.mail_forbidden; модуль «Почта» не подключён — 409 crm.module_unavailable.

## Request body

- CRMCardMailLinkRequest: Письмо, чья переписка привязывается к карточке
  - `message_id` string, uuid, required: Письмо из почты, видимое человеку

## 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`: Конфликт версии, идемпотентности или бизнес-состояния
- `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)