---
metadata:
  - name: generator
    content: Diplodoc Platform v5.52.0
alternate:
  - https://yandex.ru/dev/api360/doc/ru/routing/index.md
  - href: ru/routing/index.md
    type: text/markdown
    title: Markdown version
  - href: ../llms.txt
    type: text/markdown
    title: llms.txt
sourcePath: docs/dev/api360/concepts/gw/routing/index.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/api360/doc/ru/llms.txt

# Маршрутизация почты

API для управления правилами маршрутизации исходящей почты в организации.

## Назначение правил

Правила маршрутизации позволяют администратору организации настраивать отправку исходящих писем:

1. Принудительно отправлять письма на указанный адрес почтового сервера для заданных доменов.

1. Выбирать маршрут отправки для заданных доменов в зависимости от типа получателя:

    - на указанный адрес почтового сервера;
    - Яндекс-получателям (определяется по UID в blackbox).

1. Принудительно отправлять все исходящие письма организации на указанный адрес почтового сервера.

1. Принудительно отправлять письма внешним получателям на указанный адрес почтового сервера.

В одном правиле можно указать только один адрес почтового сервера.

## Ограничения и приоритеты {#restrictions}

- Для организации допустимо только одно правило, охватывающее все исходящие письма. Чтобы создать или удалить такое правило, укажите в качестве домена получателя пустую строку (`""`).

- Правила с указанным доменом имеют приоритет над правилом с пустым доменом.

- Приоритет работает следующим образом:

    - если домен получателя совпадает с доменом в правиле — письмо отправляется по этому правилу;
    - если совпадений нет — применяется правило с пустым доменом (`""`).

## Обработка доменов {#domain-handling}

Все операции с правилами выполняются на основе IDN-представления доменов.

Следующие варианты записи считаются идентичными:

- `домен0.орг`
- `ДОМЕН0.ОРГ`
- `xn--0-gtbd1agd.xn--c1avg`

## Разрешения {#permissions}

Разрешения на использование сервиса, которые доступны при настройке приложения:

- `ya360_admin:mail_read_domain_routes` — для просмотра правил маршрутизации;
- `ya360_admin:mail_write_domain_routes` — для создания, обновления и удаления правил.

## Endpoints {#endpoints}

- [Поиск правил маршрутизации](https://yandex.ru/dev/api360/doc/ru/routing/search-routes.md)
- [Создание и обновление правил маршрутизации](https://yandex.ru/dev/api360/doc/ru/routing/set-routes.md)
- [Удаление правил маршрутизации](https://yandex.ru/dev/api360/doc/ru/routing/remove-routes.md)