Email address management is a routine part of Exchange Online administration, especially during domain migrations, company rebranding, and tenant cleanup projects. While updating a mailbox address may seem straightforward, Exchange Online handles email identities through a proxy address system that directly affects mail routing and synchronization.
A single mailbox can contain multiple email addresses, allowing users to receive emails sent to different identities while continuing to use the same mailbox. Understanding how primary SMTP addresses and aliases work is essential for safely managing mailbox changes. This guide explains how administrators can safely add, modify, or remove mailbox addresses in both cloud only and hybrid environments.
What are Proxy Addresses in Exchange Online?
Every Exchange Online mailbox contains a list of email addresses known as proxy addresses. This collection includes one primary SMTP address and one or more secondary aliases.
Example:
- SMTP:john.doe@contoso.com
- smtp:sales@contoso.com
- smtp:support@contoso.com
Here, SMTP: (uppercase) – Indicates the mailbox’s primary email address. This is the default address used when the user sends outbound emails or replies to messages
smtp: (lowercase) – Indicates secondary aliases (proxy addresses). Emails sent to these addresses are still delivered to the same mailbox, but they are not used as the default sending identity.
The capitalization here is extremely important. The uppercase SMTP: entry defines the mailbox’s primary email address, while lowercase smtp: entries represent secondary aliases.
How to Add or Remove Email Addresses For a Mailbox in Microsoft 365
To manage email addresses in Exchange Online, the method you use depends on whether your environment is cloud-only or hybrid (synced with on-premises Active Directory).
Add an Email Address to a User Mailbox in Exchange Online
For cloud-only tenants, changes can be made directly in Exchange Online.
1. Using Exchange Admin Center
To add an additional email address to a mailbox using the Exchange Admin Center (EAC), follow these steps:
- Sign in to the Exchange admin center and navigate to Recipients > Mailboxes.
- From the list of user mailboxes, select the mailbox to which you want to add an email address. A details pane for the selected mailbox will open.
- Under General > Email addresses, click Manage email address types.
- The Manage email address types pane displays all email addresses currently linked to the mailbox. The default reply address appears in bold.
- Click the Add email address type, choose SMTP as the email address type, and then proceed to add the new SMTP email address. SMTP is the standard email address type, though custom address types can also be configured.
6. Enter the alias for the new SMTP address in the Email address field, select the required domain from the dropdown list, and click OK.
7. Finally, click Save to apply the changes.
Limitations: The Admin Center UI does not give you fine-grained control over the raw proxyAddresses attribute and cannot be used in bulk. For anything beyond simple one-off changes, PowerShell or a dedicated tool is strongly recommended.
2. Using PowerShell
Apart from the Exchange Admin Center, administrators can also use Exchange Online PowerShell to add additional email addresses to a mailbox. This method is especially useful when managing multiple users, automating changes, or performing bulk administrative tasks.
Add a single email ddress:
Use the following command to assign an additional SMTP address to a mailbox:
Set-Mailbox "Anne Wheeler" -EmailAddresses @{add="anne.wheeler@marketing.contoso.com"} This command adds the new email address while keeping the mailbox’s existing addresses intact.
Add multiple email addresses:
To add more than one alias in a single command, include multiple addresses separated by commas:
Set-Mailbox "Anne Wheeler" -EmailAddresses @{add="anne.wheeler@marketing.contoso.com","awheeler@contoso.net"} This method is useful when users require multiple aliases for different departments, domains, or business functions.
Remove an Email Address from a User Mailbox in Exchange Online
Unused aliases should be cleaned up periodically to avoid mail routing confusion and administrative clutter.
1. Using Exchange Admin Center
You can remove an existing email address or alias from a mailbox directly through the Exchange Admin Center (EAC).
- Sign in to the EAC and open Recipients > Mailboxes. Choose the user mailbox associated with the email address you want to remove.
- In the mailbox settings pane, locate the Email addresses section under General, and then select Manage email address types.
- A list of all assigned addresses will appear. Select the unwanted email address and click the Remove option.
4. Click Save to commit the changes and update the mailbox.
2. Using PowerShell:
Besides the Exchange Admin Center, Exchange Online PowerShell can also be used to remove unwanted email aliases from a mailbox.
Remove a single email address:
The following example removes an SMTP alias from the mailbox of Anne Wheeler:
Set-Mailbox "Anne Wheeler" -EmailAddresses @{remove="anne.wheeler@marketing.contoso.com"} This command deletes only the specified email address while preserving all other configured aliases.
Remove multiple email addresses:
To remove multiple aliases in a single operation, specify the addresses as a comma-separated list:
Set-Mailbox "Anne Wheeler" -EmailAddresses @{remove="anne.wheeler@marketing.contoso.com","awheeler@contoso.net"} This approach helps simplify mailbox cleanup tasks and ensures administrators can efficiently manage address changes across users.
How to Add or Remove Email Addresses in Hybrid Environments
In a hybrid setup, your on-premises Active Directory (AD) is the authoritative source. You cannot change these attributes in the cloud; changes made there will be overwritten during the next sync.
- Open Active Directory Users and Computers (ADUC): Ensure Advanced Features is enabled under the View menu.
- Locate the User: Right-click the user and select Properties.
- Edit proxyAddresses:
- Go to the Attribute Editor tab and find proxyAddresses.
- Primary Email: Prefix with uppercase SMTP: (e.g., SMTP:primary@domain.com).
- Aliases: Prefix with lowercase smtp: (e.g., smtp:alias@domain.com).
- Sync Changes: Run a delta sync using Azure AD Connect (now Microsoft Entra Connect):
Start-ADSyncSyncCycle -PolicyType DeltaLimitations with hybrid environment: When editing proxy addresses manually, there is no built-in validation or sanity checking. Common mistakes, such as:
- Forgetting the smtp: prefix,
- Configuring multiple uppercase SMTP: entries,
- Leaving trailing spaces, or
- Entering invalid or non-verified domains, or
- Configuring email addresses that already exist elsewhere in Microsoft 365 or Exchange Online.
These changes can be saved without warning and may result in incorrect mailbox behavior or synchronization issues. Exchange on-premises only checks for conflicts within on-premises Active Directory and cannot detect duplicate or conflicting addresses that already exist in Exchange Online or cloud-only accounts.
Another limitation is that verified Microsoft 365 domains are not displayed within Active Directory, so administrators must remember and type domain names manually.
Simplified Proxy Address Management with EasyEntra
Managing proxy addresses through PowerShell or raw Active Directory attributes provides flexibility, but it also requires familiarity with SMTP formatting rules, synchronization behavior, and Exchange-related conventions.
EasyEntra simplifies this process by providing a centralized graphical interface for managing proxy addresses across both cloud-only and hybrid Microsoft 365 environments. Instead of manually editing the proxyAddresses attribute, administrators can manage addresses directly from:
User Properties → Mailbox → Email Addresses.
The interface helps reduce common formatting mistakes by guiding administrators through the configuration process and presenting verified Microsoft 365 domains directly within the workflow.
Compared to traditional Active Directory or Exchange on-premises tools, EasyEntra provides additional safeguards and visibility by:
- Presenting only verified Microsoft 365 domains for selection,
- Reducing formatting errors related to SMTP address syntax,
- Helping administrators avoid duplicate or conflicting email addresses across Microsoft 365 environments,
- Eliminating the need to manually type domains or proxy address prefixes, and
- Providing a more structured and helpdesk-friendly management experience for both hybrid and cloud-only environments.
Quickly View, Add, Remove, or Update Proxy Addresses Using EasyEntra
Simplify mailbox email address management with built-in domain selection and a more structured configuration experience.
Configure Email Addresses (Proxy Addresses)
To manage a user’s email addresses in EasyEntra:
- Open the user’s Properties window and navigate to the Mailbox tab.
- Select Email Addresses to view all configured proxy addresses associated with the mailbox.
- To add a new email address:
- Enter the alias in the field next to SMTP.
- Select the required domain from the list of verified Microsoft 365 domains.
- Click Add.
4. To remove an existing address:
- Select the email address from the list.
- Click Remove.
5. To generate additional addresses automatically:
- Update the user’s Email alias.
- Choose a specific verified domain or apply the change across all domains.
- Click Add.
6. To assign a new primary SMTP address:
- Select the checkbox under the Primary column for the preferred address.
7. Click OK twice to save and apply the updated mailbox settings.
Change Email Aliases
EasyEntra also streamlines alias management for users who need multiple receiving addresses across different domains.
- Open the user account and go to the Mailbox tab.
- Select Email Addresses.
- Enter the required alias in Email alias.
- Use the Domain dropdown menu to select the appropriate domain.
- If needed, mark the alias as the primary email address using the available checkbox.
- Click OK twice to apply the configuration changes.
This interface-driven approach reduces administrative overhead and makes proxy address management significantly easier for helpdesk teams and Microsoft 365 administrators.
