Mail app password: use your mailbox's own password

You typed your password into a mail app and it came back "wrong password", so you gave up and kept using webmail. Mail apps used to need a separate mail app password. Now the password that opens your webmail is the same one that works in every mail app, and by the end of this post you will have your mailbox running in Outlook, Apple Mail, Thunderbird or your phone's mail app with nothing but your own password.

The change is described in the changelog at /changelog/2026-11-12-mail-apps-with-your-password.

What you need before you start

• A mailbox with its address, like neema@duka.co.tz.

• The password that opens that mailbox's webmail.

• A mail app: Outlook, Apple Mail, Thunderbird, or the mail app on your phone.

If you have an app password on the mailbox already, keep it in mind. You will see below when it still matters.

The steps

Add the account with your address and the mailbox's password

Open your mail app and add the account. Type your address, for example neema@duka.co.tz, and then type the password you use for webmail. That is the whole login. There is no second password to create and no mail app password to look up.

Let Outlook or Thunderbird find the settings from your address

In Outlook and Thunderbird, the server, ports and login are found from your address alone. Neema at duka.co.tz opens Outlook on her laptop, types neema@duka.co.tz and the password she uses for webmail. Outlook finds the mail server, port 993 for incoming mail and 465 for sending, and her inbox appears.

You do not type the server name or the port numbers yourself in those two apps.

On an iPhone or a Mac, install the setup profile from the mailbox's page

iPhones and Macs can still install a setup profile from the mailbox's page. Open the mailbox's page and install the setup profile there, and the settings for that phone or Mac are filled in.

Change the mailbox password whenever you want

When you change the password, your mail apps take the new one within a minute. You do not open each app and re-type anything, and you do not re-add the account.

Use an app password when the login has a second step

App passwords stay, for two cases. The first is a login with a second step: a mail app can't ask for it, so the app needs a password of its own. The second is anyone who'd rather give mail apps a password of their own.

One rule follows from this: once a mailbox has an app password, mail apps use only that one. If you set an app password and then type your own password into a mail app, the app will not accept it.

What to check that it worked

• Your inbox appears in the mail app after you enter your address and your own password.

• Incoming mail uses port 993 and sending uses port 465, as Outlook found for Neema.

• Change the mailbox password, then send a message from the app within a minute. If it goes through, the app took the new password.

• If the mailbox has an app password, the mail app logs in with that app password and not with your own.

Mistakes people make, and how to fix each

Next

The full entry, including the ports Outlook found for Neema and the cases where app passwords are still the right tool, is at /changelog/2026-11-12-mail-apps-with-your-password.