Add or remove email addresses for a mailbox in Exchange Online

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.

Tip

You can also use the Microsoft 365 admin center to add or remove email addresses for user mailboxes. For more information, see Add another email alias for a user.

What do you need to know before you begin?

Add an email address to a user mailbox

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

  1. In the 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 General > 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.

  5. Click Add Icon. 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.

  6. Type the alias for the new SMTP address in the Email address:* box, select the domain from the dropdown, and then click OK.

  7. 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.

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

Remove an email address from a user mailbox

Use the EAC to remove an email address

  1. In the 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 General > 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 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.

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,NewEmailAddress
Dan Jump,danj@northamerica.contoso.com
David Pelton,davidp@northamerica.contoso.com
Kim Akers,kima@northamerica.contoso.com
Janet Schorr,janets@northamerica.contoso.com
Jeffrey Zeng,jeffreyz@northamerica.contoso.com
Spencer Low,spencerl@northamerica.contoso.com
Toni Poe,tonip@northamerica.contoso.com

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.

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}}