Add or remove email addresses for a mailbox in Exchange Online (2023)

  • Article
  • 6 minutes to read

Important

Check out the new Exchange admin center! The experience is modern, intelligent, accessible, and better. Personalize your dashboard, manage cross tenant migration, experience the improved Groups feature, and more. Try it now!

You can configure more than one email address for the same mailbox. The additional addresses are called proxy addresses. A proxy address lets a user receive email that's sent to a different email address. Any email message sent to the user's proxy address is delivered to their primary email address, which is also known as the primary SMTP address or the default reply address.

Important

If you're using Microsoft 365 or Office 365 for business, you should add or remove email addresses for user mailboxes in the Add another email alias for a user

For additional management tasks related to managing recipients, see the "Recipients documentation" table in Recipients in Exchange Online.

What do you need to know before you begin?

  • Estimated time to complete each procedure: 2 minutes.

  • You need to be assigned permissions before you can perform this procedure or procedures. To see what permissions you need, see the "Recipients" entry in the Feature permissions in Exchange Online article.

  • For information about keyboard shortcuts that may apply to the procedures in this article, see Keyboard shortcuts for the Exchange admin center.

The procedures in this article show how to add or remove email addresses for a user mailbox. You can use similar procedures to add or remove email addresses for other recipient types.

Note

You can use similar procedures to add or remove email addresses that use plus addressing. For more information about plus addressing, see Plus Addressing.

Add an email address to a user mailbox

Use the new Exchange admin center (EAC) to add an email address

  1. In the new EAC, navigate to Recipients > Mailboxes.

  2. In the list of user mailboxes, click the mailbox that you want to add an email address to. A display pane is shown for the selected user mailbox.

  3. Under Mailbox settings > Email addresses, click the Manage email address types link.

  4. The Manage email address types display pane is shown. You can view all the email addresses associated with this user mailbox. Each email address type has one default reply address. The default reply address is displayed in bold.

    Note

    On the Email Address page, the primary SMTP address is displayed in bold text in the address list, with the uppercase SMTP value in the Type column.

  5. Click Add or remove email addresses for a mailbox in Exchange Online (1) Add email address type, and then click SMTP to add an SMTP email address to this mailbox.

    SMTP is the default email address type. You can also add custom addresses to a mailbox. For more information, see "Change user mailbox properties" in the Manage user mailboxes topic.

  6. Type the new SMTP address in the Email address:* box, and then click OK.

    The new address is displayed in the list of email addresses for the selected mailbox.

    You can select the Make this the reply address check box if you wish to make this address as the reply address.

  7. Click Save to save the change.

Use the Classic EAC to add an email address

  1. In the Classic EAC, navigate to Recipients > Mailboxes.

  2. In the list of user mailboxes, click the mailbox that you want to add an email address to, and then click Edit Add or remove email addresses for a mailbox in Exchange Online (2).

  3. On the mailbox properties page, click Email Address.

    Note

    On the Email Address page, the primary SMTP address is displayed in bold text in the address list, with the uppercase SMTP value in the Type column.

  4. Click Add Add or remove email addresses for a mailbox in Exchange Online (3), and then click SMTP to add an SMTP email address to this mailbox.

    SMTP is the default email address type. You can also add custom addresses to a mailbox. For more information, see "Change user mailbox properties" in the Manage user mailboxes topic.

  5. Type the new SMTP address in the Email address box, and then click OK.

    The new address is displayed in the list of email addresses for the selected mailbox.

  6. Click Save to save the change.

Use Exchange Online PowerShell to add an email address

The email addresses associated with a mailbox are contained in the EmailAddresses property for the mailbox. Because it can contain more than one email address, the EmailAddresses property is known as a multivalued property. The following examples show different ways to modify a multivalued property.

This example shows how to add an SMTP address to the mailbox of Dan Jump.

Set-Mailbox "Dan Jump" -EmailAddresses @{add="dan.jump@northamerica.contoso.com"}

This example shows how to add multiple SMTP addresses to a mailbox.

Set-Mailbox "Dan Jump" -EmailAddresses @{add="dan.jump@northamerica.contoso.com","danj@tailspintoys.com"}

For more information about how to use this method of adding and removing values for multivalued properties, see Modifying Multivalued Properties.

This example shows another way to add email addresses to a mailbox by specifying all addresses associated with the mailbox. In this example, danj@tailspintoys.com is the new email address that you want to add. The other two email addresses are existing addresses. The address with the case-sensitive qualifier SMTP is the primary SMTP address. You have to include all email addresses for the mailbox when you use this command syntax. If you don't, the addresses specified in the command will overwrite the existing addresses.

Set-Mailbox "Dan Jump" -EmailAddresses SMTP:dan.jump@contoso.com,dan.jump@northamerica.contoso.com,danj@tailspintoys.com

Important

Do not make frequent and multiple changes using the EmailAddress parameter. Otherwise, the changes might be lost due to a race condition within the Exchange Online sync infrastructure. As described in the previous example, we recommend adding multiple EmailAddress values in one command. Do not use multiple successive commands to add one EmailAddress value per command.

For detailed syntax and parameter information, see Set-Mailbox.

Remove an email address from a user mailbox

Use the new EAC to remove an email address

  1. In the new EAC, navigate to Recipients > Mailboxes.

  2. In the list of user mailboxes, click the mailbox that you want to remove an email address from. A display pane is shown for the selected user mailbox.

  3. Under Mailbox settings > Email addresses, click the Manage email address types link.

  4. In the list of email addresses, select the address you want to remove, and then click the Remove icon.

  5. Click Save to save the change.

Use the Classic EAC to remove an email address

  1. In the Classic EAC, navigate to Recipients > Mailboxes.

  2. In the list of user mailboxes, click the mailbox that you want to remove an email address from, and then click Edit Add or remove email addresses for a mailbox in Exchange Online (4).

  3. On the mailbox properties page, click Email Address.

  4. In the list of email addresses, select the address you want to remove, and then click Remove Add or remove email addresses for a mailbox in Exchange Online (5).

  5. Click Save to save the change.

Use Exchange Online PowerShell to remove an email address

This example shows how to remove an email address from the mailbox of Janet Schorr.

Set-Mailbox "Janet Schorr" -EmailAddresses @{remove="janets@corp.contoso.com"}

This example shows how to remove multiple addresses from a mailbox.

Set-Mailbox "Janet Schorr" -EmailAddresses @{remove="janet.schorr@corp.contoso.com","janets@tailspintoys.com"}

For more information about how to use this method of adding and removing values for multivalued properties, see Modifying Multivalued Properties.

You can also remove an email address by omitting it from the command to set email addresses for a mailbox. For example, let's say Janet Schorr's mailbox has three email addresses: janets@contoso.com (the primary SMTP address), janets@corp.contoso.com, and janets@tailspintoys.com. To remove the address janets@corp.contoso.com, you would run the following command.

Set-Mailbox "Janet Schorr" -EmailAddresses SMTP:janets@contoso.com,janets@tailspintoys.com

Because janets@corp.contoso.com was omitted in the previous command, it's removed from the mailbox.

For detailed syntax and parameter information, see Set-Mailbox.

Use Exchange Online PowerShell to add email addresses to multiple mailboxes

You can add a new email address to multiple mailboxes at one time by using Exchange Online PowerShell and a comma separated values (CSV) file.

This example imports data from C:\Users\Administrator\Desktop\AddEmailAddress.csv, which has the following format.

Mailbox,NewEmailAddressDan Jump,danj@northamerica.contoso.comDavid Pelton,davidp@northamerica.contoso.comKim Akers,kima@northamerica.contoso.comJanet Schorr,janets@northamerica.contoso.comJeffrey Zeng,jeffreyz@northamerica.contoso.comSpencer Low,spencerl@northamerica.contoso.comToni Poe,tonip@northamerica.contoso.com...

Run the following command to use the data in the CSV file to add the email address to each mailbox specified in the CSV file.

Import-CSV "C:\Users\Administrator\Desktop\AddEmailAddress.csv" | ForEach {Set-Mailbox $_.Mailbox -EmailAddresses @{add=$_.NewEmailAddress}}

Note

The column names in the first row of this CSV file ( Mailbox,NewEmailAddress) are arbitrary. Whatever you use for column names, make sure you use the same column names in Exchange Online PowerShell command.

Tip

Having problems? Ask for help in the Exchange forums. Visit the forums at Exchange Online or Exchange Online Protection.

Top Articles
Latest Posts
Article information

Author: Kieth Sipes

Last Updated: 09/25/2022

Views: 6203

Rating: 4.7 / 5 (67 voted)

Reviews: 82% of readers found this page helpful

Author information

Name: Kieth Sipes

Birthday: 2001-04-14

Address: Suite 492 62479 Champlin Loop, South Catrice, MS 57271

Phone: +9663362133320

Job: District Sales Analyst

Hobby: Digital arts, Dance, Ghost hunting, Worldbuilding, Kayaking, Table tennis, 3D printing

Introduction: My name is Kieth Sipes, I am a zany, rich, courageous, powerful, faithful, jolly, excited person who loves writing and wants to share my knowledge and understanding with you.