Лимиты

Всё, что ограничено, — в одном месте. Опубликовано, а не обнаружено на практике: лимит, о который спотыкаются неожиданно, — это баг документации.

Кратко

1/сек
Запросы к API на адрес
Опрос раз в секунду — предусмотренный режим работы.
5дней
Срок хранения сообщений
С момента получения, прочитано или нет. Жёсткий лимит.
5MB
Максимальный размер сообщения
Отклоняется на этапе SMTP, поэтому отправитель об этом узнаёт.
∞
Адресов на домен
Заранее ничего не создаётся, поэтому и считать нечего.
200
Сообщений за один запрос
По умолчанию 50. Это ограничивает один ответ, а не сам ящик: next листает всё остальное, сколько бы его ни было.
0
Исходящие сообщения
Эндпоинта для отправки нет. Так и задумано.

Лимит запросов

Один запрос в секунду на адрес. Лимит действует на почтовый ящик, а не на IP-адрес, поэтому общий CI-раннер, опрашивающий двадцать разных ящиков, не конкурирует сам с собой.

При превышении лимита вы получите 429 с заголовком Retry-After в целых секундах. Нет ни суточной квоты, ни месячной, ни запаса на всплеск нагрузки.

Есть и второй предел, и он указан здесь, а не оставлен на самостоятельное обнаружение: 1200 запросов в минуту с одного исходного адреса. Это ровно тот же пример с двадцатью почтовыми ящиками в секунду, приведённый выше, поэтому обычная автоматизация никогда его не достигает — он существует, чтобы один хост не мог перебрать десять тысяч адресов в секунду.

HTTP/1.1 429 Too Many Requests
Retry-After: 1
Content-Type: application/json

{
  "error":   "rate_limited",
  "message": "one request per second, per address"
}

Ориентируйтесь на Retry-After, а не на фиксированную паузу. Если лимит когда-нибудь изменится, код, читающий этот заголовок, продолжит работать.

Размер сообщения

Сообщения размером до 5 MB, включая вложения. Это ограничение применяется почтовым сервером во время SMTP-сессии, и это важно: отправляющий сервер узнаёт об этом в момент попытки и сообщает своему пользователю о реальной ошибке — вместо того чтобы сообщение просто исчезло.

Что учитывается: Всё закодированное сообщение целиком — заголовки, тело и все вложения после MIME-кодирования. Base64 увеличивает размер бинарных данных примерно на треть, так что файл в 20 МБ уже близок к пределу.
Что происходит на линии: Код 552 во время сеанса SMTP. Сообщение никогда не сохраняется и никогда не появляется в почтовом ящике.
Вложений на сообщение: Отдельного лимита нет. Важна только общая сумма.

Срок хранения

Сообщение удаляется через 5 дней после получения, прочитано оно или нет, и отсчёт начинается с момента доставки, а не первого прочтения.

У каждого сообщения есть expires_at, так что клиенту никогда не нужно вычислять эту дату или отслеживать политику.

Это жёсткий лимит, а не настройка: ни параметр, ни тариф, ни аккаунт его не продлевают. Если что-то должно пережить это окно, получите это и сохраните у себя.

Адреса и домены

Адресов на домен: Без ограничений и без подсчёта. Поскольку почтовый ящик никогда не создаётся, нет и списка, который мог бы расти.
Правила локальной части: От одного до 64 символов: буквы, цифры, точка, дефис, подчёркивание и плюс. Должен начинаться и заканчиваться буквой или цифрой. Всё остальное отклоняется ещё до почтового сервера — и в браузере, и повторно на сервере.
Плюс-адресация: name+tag@domain здесь отдельный почтовый ящик, а не псевдоним name@domain. Это сделано намеренно — тегами люди разделяют регистрации, и объединение адресов слило бы ящики, которые должны были оставаться раздельными.
Регистр: Всё приводится к нижнему регистру. Name@ и name@ — один и тот же ящик.
Собственные домены: Нет ограничений на число доменов, которые вы сюда направите. Каждому нужна своя MX-запись.

Добросовестное использование

Нет квоты, которую можно купить, и нет тарифа, повышающего эти цифры. Вместо этого есть другое: если один источник ухудшает сервис для всех остальных, его останавливают.

Массовый опрос: Тысячи почтовых ящиков, опрашиваемых каждую секунду с одного источника, будут ограничены на краю сети ещё до того, как запрос дойдёт до API.
Почтовые потоки: Отправляющий хост, открывающий неоправданно много SMTP-соединений, блокируется на десять минут. Обычные отправители никогда не приближаются к этому пределу.
Использование нас в качестве ретранслятора: Невозможно, а не запрещено: почтовый сервер принимает только сообщения, адресованные размещённым здесь доменам, поэтому он не может ничего никуда пересылать.

Всё это не рассчитано на обычную автоматизацию как исключение. Опрашивать раз в секунду, весь день, по тысячам почтовых ящиков — это и есть предполагаемое использование, а не его крайний случай.