---
title: "Добавить заметку в ленту записи"
method: POST
path: "/api/v1/crm/{entity}/{id}/notes"
tags: ["CRM links"]
---

# Добавить заметку в ленту записи

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

## Request

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

Заметка пишется один раз и дальше не редактируется. Коллег упоминают через «@Имя» в тексте и их номера в mentioned_user_ids: каждый упомянутый получает уведомление crm_mention (ERP-1607). Не сотрудник кабинета — 422 crm.mention_not_member, больше 20 упомянутых — 400 crm.mention_too_many.

## Request body

- CRMNoteInput
  - `text` string, required
  - `mentioned_user_ids` integer[]: Упомянутые коллеги — номера сотрудников из GET /api/v1/crm/members. Засчитывается тот, чьё «@Имя» стоит в тексте заметки

## Response `201`

Запись ленты

- CRMActivity: Лента только дописывается
  - `id` string, uuid, required
  - `entity_type` 'lead' | 'deal' | 'customer', required
  - `entity_id` string, uuid, required
  - `action` string, required: Ключ факта; note - заметка сотрудника
  - `details` object, nullable, required: Подробности факта. У заметки: text - текст, mentions - упомянутые коллеги [{id, name}]
  - `actor_id` integer, required
  - `actor_name` string
  - `created_at` string, date-time, required

## Other responses

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

---

[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)