Microsoft Outlook

You can work with Yandex Mail using Microsoft Outlook.

  1. Step 1. Configure your mailbox
  2. Step 2. Create an app password
  3. Step 3. Configure IMAP-based client
  4. Troubleshooting Microsoft Outlook issues

Step 1. Configure your mailbox

  1. Open “Email clients” in Yandex Mail settings.
  2. Select the following options: From the imap.yandex.com server via IMAP and App passwords and OAuth tokens.
  3. Save changes.
Note. If you want the emails to be kept for some time after they are deleted in the mail client, select Don't automatically delete emails marked as deleted in IMAP. Please note that they will be permanently deleted from the mailbox immediately after restarting the email client.

Step 2. Create an app password

  1. In your Yandex ID account, go to App passwords and click Create an app password.
  2. Select the application type Mail.
  3. Come up with a password name. For example, you may enter the name of the app you're creating the password for. The password will be displayed in the list under this name.
  4. Click Create. The app password will be displayed in a pop-up window.
Restriction. You can only see the created password once. If you entered it incorrectly and closed the window, delete the current password and create a new one.

Step 3. Configure IMAP-based client

  1. Launch the program. Enter your email address, select Advanced parameters → Set up an account manually and click Connect.

  2. Enter the app password that you created for Yandex Mail. Click Enable.

  3. Select IMAP.

  4. Set the following account settings:

    Incoming mail:

    • Server:imap.yandex.com.
    • Port: 993

    Outgoing mail:

    • Server: smtp.yandex.com.
    • Port: 465

    Leave default values for other parameters and click Next to test the account settings. If all the settings are correct and confirmed, click Finish. If not, make sure that all the details are entered properly.

Changing the server settings

After the initial setup, you may need to change the previously entered data or perform a more precise server configuration. To do this:

  1. Open Control panel on your device and go to User accounts. Open Mail (Microsoft Outlook 2016).

  2. In the window that opens, select an account or click Add to create a new configuration.

  3. Select Manual setup or additional server types and click Next.

  4. Select POP or IMAP and click Next.

  5. Set the following account settings:

    • Your Name — user name (for example, “Alice Little”)
    • Email address — your Yandex email address (for example, “alice.the.girl@yandex.ru”)
    • Type of account — IMAP.
    • Incoming mail server — imap.yandex.com
    • Outgoing email server (SMTP) — smtp.yandex.com
    • User — your Yandex username
    • Password: The app password you created for Yandex Mail.
    Attention. If you are configuring email delivery from a mailbox such as “login@yandex.com”, your username is the first part of the address before the “@” symbol. If you're using Yandex 360 for Business, enter your full email address as the username.

    Leave default values for other parameters and click Other settings.

  6. Go to the Outgoing mail server tab, enable the SMTP server requires authentication checkbox, and select the Same as incoming mail server value.

  7. Go to the Advanced tab. For the Use the following type of encrypted connection option, choose SSL for the IMAP and SMTP servers. Set the following parameters:

    • IMAP server — 993
    • SMTP server — 465

    Leave default values for other parameters and click OK.

  8. To finish account configuration, click Next in the Add a new account window to test the account settings. If all the settings are correct and confirmed, click Finish. If not, make sure that all the details are entered properly.

Troubleshooting Microsoft Outlook issues

Using this step-by-step guide, you'll be able to resolve issues with Yandex Mail and the email client.

Select a problem:

Which message is it?

Try logging in on the Yandex Mail website with the same username and password that you use in the email client. Enter your username and password manually without using auto-fill.

Note. If you're using the app password to log in, make sure that the From the imap.yandex.com server via IMAP and App passwords and OAuth tokens options are enabled in the Yandex Mail settings.
Were you able to log in?

It means the problem occurred because you didn't accept the User Agreement for Yandex Services. It is accepted automatically when you log in to Yandex Mail for the first time.

If you're a part of a company and all the mailboxes with this domain experience this problem, you need to log in to Yandex Mail for each of them. There is no way to do it automatically for all mailboxes at once, because each Yandex Mail user must accept the User Agreement themselves.

Go to Email clients in the Yandex Mail settings. Make sure that the From the imap.yandex.com server via IMAP option is selected and the correct authorization method is specified.

Make sure your email client settings are configured as follows:

When using IMAP
Incoming mail
  • mail server address — imap.yandex.com
  • connection security — SSL
  • port — 993
Outgoing mail
  • mail server address — smtp.yandex.com
  • connection security — SSL
  • port — 465

Open Yandex Mail and go to Settings → Email clients. Make sure you have the From the imap.yandex.com server via IMAP and App passwords and OAuth tokens options selected.

When using POP3
Incoming mail
  • mail server address — pop.yandex.com
  • connection security — SSL
  • port — 995
Outgoing mail
  • mail server address — smtp.yandex.com
  • connection security — SSL
  • port — 465

Go to Email clients in the Yandex Mail settings. Make sure that the From the imap.yandex.com server via POP3 option is selected.

See Data in transit encryption for more details on checking server settings in different mail clients.


If you were unable to log in, the credentials you entered may have been incorrect.

If you see a message that says “Authentication required”, “Sender address rejected: Access denied” or “Send auth command first”, authorization for the Yandex SMTP server is disabled in the mail client settings. Make sure that the Check user authentication (for Outlook Express) or SMTP authentication (for The Bat!) is enabled.

Also try logging in to Yandex Mail with the same username and password you use in the email client.

Note. If you're using the app password to log in, make sure that the From the imap.yandex.com server via IMAP and App passwords and OAuth tokens options are enabled in the Yandex Mail settings.

If you logged in successfully without any errors, this means the problem occurred because you didn't accept the User Agreement for Yandex Services. It is accepted automatically when you log in to the Yandex Mail web interface for the first time.

If you are a part of a company and all the mailboxes with this domain experience this problem, you need to log in to the web interface for each of them. There is no way to do it automatically for all mailboxes at once, because each Yandex Mail user must accept the User Agreement themselves.

If you receive the message “Sender address rejected: not owned by auth user”, the address in the From field doesn't match the address that you've specified in the mail client settings for SMTP authentication. Correct the address and re-send the email.

Also try logging in to Yandex Mail with the same username and password you use in the email client.

Note. If you're using the app password to log in, make sure that the From the imap.yandex.com server via IMAP and App passwords and OAuth tokens options are enabled in the Yandex Mail settings.

If you logged in successfully without any errors, this means the problem occurred because you didn't accept the User Agreement for Yandex Services. It is accepted automatically when you log in to the Yandex Mail web interface for the first time.

If you are a part of a company and all the mailboxes with this domain experience this problem, you need to log in to the web interface for each of them. There is no way to do it automatically for all mailboxes at once, because each Yandex Mail user must accept the User Agreement themselves.

If you receive the message “Username failure or POP3 disabled”, the mail program cannot access the mailbox over POP3. Make sure you entered the correct password and the POP3 protocol is enabled in the settings under Email clients.

Also try logging in to Yandex Mail with the same username and password you use in the email client.

If you logged in successfully without any errors, this means the problem occurred because you didn't accept the User Agreement for Yandex Services. It is accepted automatically when you log in to the Yandex Mail web interface for the first time.

If you are a part of a company and all the mailboxes with this domain experience this problem, you need to log in to the web interface for each of them. There is no way to do it automatically for all mailboxes at once, because each Yandex Mail user must accept the User Agreement themselves.

If you receive the “Message rejected under suspicion of SPAM” error, this means that Yandex Mail recognized the contents of your email as spam. To solve the problem, go to Yandex Mail and send a test email. This shows the system that messages are not being sent by a robot.

Check your computer for viruses using free antivirus programs, like CureIt! by Dr.Web or Kaspersky Virus Removal Tool.

For more information, see I got the message "Email can't be sent, because it appears to be spam".

If you receive the message "Bad address mailbox syntax", check the address in the From field. Correct the address and re-send the email.

  • Make sure your email client and your computer internet connection are set up correctly.
  • If you use an anti-virus program, firewall, or proxy server, disable them and see if the problem persists.

  • Enter your valid personal details in Yandex ID and link your phone number to your account. It may be that our security system considers your account suspicious and blocked the mailbox. This usually happens if you don't link a phone number to your mailbox or enter a fake name in Yandex ID. It usually takes a couple of hours to unblock the mailbox.

  • Also try logging in to Yandex Mail with the same username and password you use in the email client.

    Note. If you're using the app password to log in, make sure that the From the imap.yandex.com server via IMAP and App passwords and OAuth tokens options are enabled in the Yandex Mail settings.

    If you logged in successfully without any errors, this means the problem occurred because you didn't accept the User Agreement for Yandex Services. It is accepted automatically when you log in to the Yandex Mail web interface for the first time.

    If you are a part of a company and all the mailboxes with this domain experience this problem, you need to log in to the web interface for each of them. There is no way to do it automatically for all mailboxes at once, because each Yandex Mail user must accept the User Agreement themselves.

  • "Bad address mailbox syntax" Check the sender's address in the From field. If the address is incorrect, you'll see the error:

Read our step-by-step email search instructions. Before you start, open Yandex Mail in a new tab.

Select a problem:

When you delete an email message, it is sent to the Trash folder, where it is stored for 30 days. Messages can be restored during this period:

  1. Go to Trash.
  2. Select the messages you want want to restore.
  3. Click To folder.
  4. Choose the folder where you want to move the selected messages, like Inbox.

Messages deleted longer than one month ago can't be restored as they are permanently removed from the Yandex Mail servers.

If email messages are not in the folder where they should be, they probably ended up in another folder, such as Trash or Spam. If you remember the sender's name, address, or a part of the message text or subject, try to search for the message in all the folders in your mailbox.

Did you find the messages?

You can recover email:

  1. Go to the folder where you found the email.
  2. Select the messages you want to restore.
  3. Click To folder.
  4. Choose the folder where you want to move the selected messages, like Inbox.
Why email disappears and how to avoid this

Emails is stored in the Trash folder for 30 days and in the Spam folder for 10 days. Afterwards, they are permanently removed from the Yandex servers. Why email may end up in these folders without your knowing it:

Another user has access to your mailbox.

Messages may be deleted by a user who has access to your mailbox if you forgot to log out on someone else's device. To end the session, click Log out from all devices in the account menu. You can also do this in the Yandex ID settings using the link Log out on all devices.

Go to the session history log and check for any delete email operations.

Restriction. The log stores about 2000 operations. If more than 2000 actions were performed after the messages were deleted, data on the delete operation will not be displayed in the log.

If you are sure that only you have access to your mailbox, test your computer with an antivirus software, change the password and alternative address. You should also make sure there aren't any unknown phone numbers on the Phone numbers page.

Email gets lost in the mail client

If you use an email client and delete email in it, messages are removed from the service page as well. This is because your client uses the IMAP protocol, and the inbox in your client is synced with the service. You can delete messages from the client, but keep them in Yandex Mail by configuring the client using POP3. However, we don't recommend this as messages might not sync with the server correctly.

This is a filter that deletes or moves email messages

Make sure there are no mail filters that delete incoming messages or move them to other folders. If this is the case, temporarily disable them and check if messages arrive in your Inbox folder.

If you couldn't find the emails manually or using the search tool, this means they can't be restored as they have been permanently removed from the Yandex Mail servers.

Why email disappears and how to avoid this

Emails is stored in the Trash folder for 30 days and in the Spam folder for 10 days. Afterwards, they are permanently removed from the Yandex servers. Why email may end up in these folders without your knowing it:

Another user has access to your mailbox.

Messages may be deleted by a user who has access to your mailbox if you forgot to log out on someone else's device. To end the session, click Log out from all devices in the account menu. You can also do this in the Yandex ID settings using the link Log out on all devices.

Go to the session history log and check for any delete email operations.

Restriction. The log stores about 2000 operations. If more than 2000 actions were performed after the messages were deleted, data on the delete operation will not be displayed in the log.

If you are sure that only you have access to your mailbox, test your computer with an antivirus software, change the password and alternative address. You should also make sure there aren't any unknown phone numbers on the Phone numbers page.

Email gets lost in the mail client

If you use an email client and delete email in it, messages are removed from the service page as well. This is because your client uses the IMAP protocol, and the inbox in your client is synced with the service. You can delete messages from the client, but keep them in Yandex Mail by configuring the client using POP3. However, we don't recommend this as messages might not sync with the server correctly.

This is a filter that deletes or moves email messages

Make sure there are no mail filters that delete incoming messages or move them to other folders. If this is the case, temporarily disable them and check if messages arrive in your Inbox folder.

If new messages are not in the Inbox, they most likely ended up in another folder, such as Trash or Spam. If you remember the sender's name, address, or a part of the message text or subject, try to search for the message in all folders in your mailbox.

Did you find the messages?

If you found the email in Trash, Spam or another folder, you most likely set up filters that delete messages or move them to Spam or another folder. If this is the case, disable them temporarily and check if the messages arrive in your Inbox.

If the new messages are still missing, check that you entered your email address correctly on the website you expect to receive email from. Find out if the sender recorded your email address correctly.

Check that the site's or sender's email address hasn't been blacklisted.

Enter your valid personal details in Yandex ID and link your phone number to your account. It may be that our security system considers your account suspicious and blocked the mailbox. This usually happens if you don't link a phone number to your mailbox or enter a fake name in Yandex ID. It usually takes a couple of hours to have your account unblocked.

If you delete emails in your email client, but they are still in your Yandex Mail folders, your email client most likely uses POP3. Due to certain features of the POP3 protocol, email client mail may not sync correctly with the server. We recommend using the IMAP protocol for Yandex Mail. To learn more about how to switch between POP3 and IMAP, go to Switching from POP3.

If your mail client doesn't display sent email, it probably means that it uses POP3. Due to certain features of the POP3 protocol, email client mail may not sync correctly with the server. We recommend using the IMAP protocol for Yandex Mail. To learn more about how to switch between POP3 and IMAP, go to Switching from POP3.

The report always refers to the cause for non-delivery. You can read about the most common reasons in Non-delivery report for Yandex and Non-delivery report for other address (not Yandex).

If during the activation of SSL-encryption you get errors about an incorrect certificate, make sure that the mail client and the operating system are configured correctly:

  • The correct time (without any delays and “dates from the future”) is set on the computer. If the wrong date is set, the system erroneously defines the certificate period as not yet started or already expired.
  • All updates of the operating system are installed.
  • Checking of the HTTPS-connections is disabled in the settings of your antivirus software To change the settings of your anti-virus software, check the guides for Kaspersky Internet Security and ESET NOD32 Smart Security in the Security certificate errors section.
Add the certificate to the list of trusted certificates manually (Windows)
Attention. If you are not sure that you can install the certificate yourself, contact a specialist.

To add the certificate to the list of trusted certificates:

  1. Download the certificate. (If the file opens by following the link directly in the browser, press CTRL + S and save the file on the computer; there is no need to copy the text from the file.)
  2. Open the Start menu.
  3. Enter certmgr.msc in the search field and press Enter.
  4. In the program, click on the Trusted root certification authorities folder in the folder tree.
  5. Right-click on Certificates in the right part of the window and choose All tasks → Import.
  6. Click Next.
  7. Click on View and select the earlier downloaded file CA.pem. Tap Next.
  8. Leave the default settings in the Storage of certificates section and click Next.
  9. Click Done.
  10. (Optional) Click Accept in the popup window.
  11. Click on the folder Trusted root certification authorities → Certificates in the folder tree.
  12. In the list of certificates (on the right), find the certificate Certum CA, right-click on it and select Properties.
  13. Go to the General tab.
  14. Make sure that the option Server authentication is enabled in Allow only the following destinations.
  15. Click OK.
Adding the root certificate to Linux
The information on adding the root certificate is provided in the instructions Adding CAcert root certificate to Debian/Ubuntu.
Problems with confirmation of the certificate in The Bat!

If you have problems confirming certificates in The Bat! mail client, update the program to version 6 or later. Perform the following actions after the update:

  1. Choose Properties → S/MIME and TLS in the program menu.
  2. Set S/MIME Implementation and TLS certificates to Internal.
  3. Click OK.
  4. Try sending an email. If you get a certificate error again, go back to Properties → S/MIME and TLS → S/MIME implementation and TLS certificates and set it to Mircosoft CryptoAPI.
  5. Click OK.
Note. You need to switch the options manually because Internal only works in some versions of The Bat!, whereas Microsoft CryptoAPI only works in others.

If after all this the problem still persists, contact the Ritlabs support service.

Reconfiguration of your send script fails

Try to compare your code with the guidelines in the network:

1C software does not support SSL

To support SSL, install additional Stunnel software:

  1. Download the latest version for Windows (stunnel-version-installer.exe) from https://www.stunnel.org/downloads.html.
  2. Unpack the archive
  3. Execute file mailssl.bat as administrator.
  4. Disable SSL in the mail client settings and specify the following parameters of the servers:
    • SMTP: server — localhost, port — 25
    • POP3: server — localhost, port — 110
    • IMAP: server — localhost, port — 143

If you have changed the mailbox password recently, make sure that you also update the settings in your email client. If the password in the settings is correct, wait a few hours: the email client settings may need time to synchronize with the Yandex server.

Try logging in using the same username and password in the web-interface: enter the authentication data again. If you're asked to enter captcha characters, you can check a list of possible reasons in Why do I have to enter captcha numbers during authorization?.

Go to Email clients in the Yandex Mail settings. Make sure that the From the imap.yandex.com server via IMAP option is selected and the correct authorization method is specified.

Attention. If you're using Yandex 360 for Business, enter your full mailbox address as your username.
Make sure that the IMAP or POP3 protocol is enabled in the Mail clients section.