[Документация Yandex Cloud](../../index.md) > [Yandex Cloud Postbox](../index.md) > Справочник API > SMTP > Ответы SMTP

# Ответы SMTP

При отправке писем по протоколу SMTP Yandex Cloud Postbox возвращает ответы в формате SMTP: числовой код ответа, расширенный код состояния (`enhanced status code`) и текстовое пояснение. Для ответов с кодом 4xx или 5xx к тексту добавляется идентификатор запроса `RequestID`. Укажите его при обращении в поддержку.

```
550 5.4.1 identity not verified RequestID: <request-id>
```

## Успешные ответы {#success}

#|
|| **Код** | **Расширенный код** | **Текст** | **Значение** ||
|| `250` | `2.6.0` | `OK: queued as <message-id>` | Письмо принято и поставлено в очередь на отправку. `<message-id>` — идентификатор сообщения. ||
|#

## Временные ошибки 4xx {#temporary-errors}

Ответы с кодом 4xx означают, что запрос можно повторить позже.

#|
|| **Код** | **Расширенный код** | **Текст** | **Причина** | **Что делать** ||
|| `421` | `4.3.0` | `Unexpected error.` | Внутренняя ошибка сервиса или непредвиденная ошибка обработки. | Повторите отправку позже. Если ошибка повторяется, обратитесь в поддержку с `RequestID`. ||
|| `451` | `4.4.2` | `Timeout waiting for data from client` | Истек тайм-аут ожидания тела письма или соединение было разорвано во время передачи данных. | Проверьте сетевое соединение и тайм-ауты клиента, повторите отправку. ||
|| `452` | `5.5.3` | `Maximum limit of <N> recipients reached` | Превышен лимит получателей на одно письмо. | Разбейте отправку на несколько писем с меньшим числом получателей. ||
|| `454` | — | `Maximum sending rate exceeded` | Превышена допустимая частота отправки (`rate limit`) для облака. | Снизьте темп отправки и повторите запрос позже. ||
|#

## Постоянные ошибки 5xx {#permanent-errors}

Ответы с кодом 5xx означают, что запрос не будет выполнен без изменений. Повторять его в том же виде бессмысленно.

### Аутентификация и авторизация {#auth}

#|
|| **Код** | **Расширенный код** | **Текст** | **Причина** | **Что делать** ||
|| `538` | `5.7.8` | `Authentication credentials invalid` | Логин или пароль не переданы либо учетные данные имеют неверный формат подписи или кодировки Base64. | Проверьте имя пользователя и пароль SMTP. ||
|| `535` | `5.7.8` | `Authentication failed` | Не прошла проверка учетных данных: неверный IAM-токен, API-ключ или статический ключ. | Проверьте актуальность и корректность учетных данных. ||
|| `534` | `5.7.8` | `Authorization failed` | Ошибка при проверке прав доступа. | Повторите запрос позже. Если ошибка повторится, обратитесь в поддержку. ||
|| `534` | `5.7.8` | `Not enough permissions` | Учетные данные корректны, но у сервисного аккаунта нет права на отправку писем. | Назначьте сервисному аккаунту [роль](../security/index.md#service-roles) `postbox.sender` или выше. ||
|#

### Порядок команд и TLS {#commands-and-tls}

#|
|| **Код** | **Расширенный код** | **Текст** | **Причина** | **Что делать** ||
|| `530` | `5.7.0` | `Must issue a STARTTLS command first` | Команда отправлена по незашифрованному соединению. | Установите TLS-соединение (STARTTLS или SMTPS) перед аутентификацией и отправкой. ||
|| `502` | `5.7.0` | `Please authenticate first` | Команда `MAIL FROM`, `RCPT TO` или `DATA` выполнена до успешной аутентификации. | Выполните `AUTH` перед отправкой письма. ||
|#

### Отправитель и получатели {#sender-and-recipients}

#|
|| **Код** | **Расширенный код** | **Текст** | **Причина** | **Что делать** ||
|| `550` | — | `Empty envelope senders not allowed` | Аутентифицированный клиент указал пустой адрес отправителя (`MAIL FROM:<>`). | Укажите корректный адрес отправителя. ||
|| `550` | `5.4.1` | `identity not found` | Адрес отправителя не найден. | Проверьте, что адрес отправителя создан в Yandex Cloud Postbox. ||
|| `550` | `5.4.1` | `identity not verified` | Адрес отправителя не подтвержден. | Завершите [проверку владения доменом](../operations/check-domain.md). ||
|| `550` | `5.4.1` | `identity is blocked` | Адрес отправителя заблокирован. | Обратитесь в поддержку для выяснения причины блокировки. ||
|| `550` | `5.7.1` | `sender is not allowed` | Отправитель не входит в список разрешенных для адреса. | Используйте [разрешенного отправителя](../operations/restrict-senders.md) или добавьте отправителя в список разрешенных. ||
|#

### Квоты и размер сообщения {#quotas-and-message-size}

#|
|| **Код** | **Расширенный код** | **Текст** | **Причина** | **Что делать** ||
|| `550` | `5.4.5` | `Daily sending quota exceeded.` | Исчерпана суточная квота на отправку. | Дождитесь сброса квоты или запросите ее увеличение. ||
|| `550` | `5.5.3` | `too many recipients (recipient count quota exceeded)` | Превышена квота на количество получателей. | Уменьшите число получателей или запросите увеличение квоты. ||
|| `552` | `5.3.4` | `message is too big (message size quota exceeded)` | Превышена квота на размер письма. | Уменьшите размер письма: тело письма или вложения. ||
|| `552` | `5.3.4` | `Maximum message size exceeded` | Размер письма превышает технический лимит сервера. | Уменьшите размер письма. ||
|#

### Синтаксис и валидация {#syntax-and-validation}

#|
|| **Код** | **Расширенный код** | **Текст** | **Причина** | **Что делать** ||
|| `500` | — | `Line too long` | Слишком длинная строка команды. | Проверьте формат SMTP-команд и сократите строки с учетом [ограничения длины строки](https://datatracker.ietf.org/doc/html/rfc2822#section-2.1.1) в RFC 2822. ||
|| `500` | — | `validation failed` или конкретное сообщение валидации | Запрос не прошел валидацию. | Исправьте письмо согласно тексту ошибки. ||
|| `501` | — | `Syntax error in parameters or arguments` | Не удалось разобрать адрес в команде `MAIL FROM` или `RCPT TO`, либо адрес пустой. | Проверьте корректность адресов отправителя и получателей. ||
|#

## Идентификатор запроса {#request-id}

Если ответ содержит `RequestID: <request-id>`, сохраните этот идентификатор и приложите его при обращении в поддержку: он ускорит диагностику.