---
title: "Привязать адресата к контрагенту"
method: PUT
path: "/api/v1/mail/address-book/entries/{id}/contact"
tags: ["Mail messages"]
---

# Привязать адресата к контрагенту

`PUT /api/v1/mail/address-book/entries/{id}/contact`

## Request

- Base URL: `https://erp.akeda.ru`
- URL: `https://erp.akeda.ru/api/v1/mail/address-book/entries/{id}/contact`
- 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`)

Привязывает адрес из книги к уже заведённому контрагенту справочника core или снимает привязку (contact_id равен null). Контрагент проверяется справочником: пропавший или архивный даёт 400. Контрагент из почты не заводится. Нужны право записи почты и право чтения справочника.

## Request body

- object
  - `contact_id` string, uuid, required

## Response `200`

Запись после привязки

- MailAddressBookRecord: Адресат из адресной книги почты
  - `id` string, uuid, required
  - `email` string, required: Адрес строчными буквами, уникален в кабинете
  - `name` string, required
  - `contact_id` string, uuid, required
  - `created_by` integer, nullable, required: Кто сохранил адресата
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

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

---

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