Manage accepted domains in Exchange Online

When you add your domain to Office 365, it's called an accepted domain. This means that users in this domain can send and receive mail. For more information on how to add your domain to Office 365 using the Office 365 admin center, see Add a domain to Office 365.

After you add your domain using the Office 365 admin center, you can use the Exchange admin center (EAC) to view your accepted domains and configure the domain type.

There are two types of accepted domains in Exchange Online:

  • Authoritative: Email is delivered to email addresses that are listed for recipients in Office 365 for this domain. Emails for unknown recipients are rejected.

    • If you just added your domain to Office 365 and you select this option, it's critical that you add your recipients to Office 365 before setting up mail to flow through the service.

    • Typically, you use this option when all the email recipients in your domain are using Office 365. You can also use it if some recipients exist on your own email servers. However, if recipients exist on your own email servers, you must add your recipients to this Office 365 domain in order to make sure that mail is delivered as expected. For more information about how to manage your recipients, see these topics:

    • Setting this option enables Directory Based Edge Blocking (DBEB), which rejects messages for invalid recipients at the service network perimeter. For more information about configuring DBEB during a migration, see Use Directory Based Edge Blocking to reject messages sent to invalid recipients.

  • Internal relay (also known as non-authoritative): Recipients for this domain can be in Office 365 or your own email servers. Email is delivered to known recipients in Office 365 or is relayed to your own email server if the recipients aren't known to Office 365.

    • You should not select this option if all of the recipients for this domain are in Office 365.

    • If you select this option, you must create a connector for mail flow from Office 365 to your on-premises email server; otherwise recipients on the domain who are not hosted in Office 365 won't be able to receive mail on your own email servers. For more information about setting up connectors, see Set up connectors to route mail between Office 365 and your own email servers.

    • This option is required if you enable the subdomain routing option on a domain in order to let email pass through the service and be delivered to any subdomains of your accepted domains. For more information, see Enable mail flow for subdomains in Exchange Online.

What do you need to know before you begin?

Tip

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

View accepted domains

Use the EAC to view accepted domains

  1. In the EAC, go to Mail flow > Accepted domains.

  2. Click the Name, Accepted Domain, or Domain Type column heading to sort alphabetically in ascending or descending order. By default, accepted domains are sorted alphabetically by name in ascending order.

Use Exchange Online PowerShell to view accepted domains

To view summary information about all accepted domains, run the following command:

Get-AcceptedDomain

To view details about a specific accepted domain, use the following syntax.

Get-AcceptedDomain -Identity <Name> | Format-List

This example shows details about the accepted domain named contoso.com.

Get-AcceptedDomain -Identity contoso.com | Format-List

Configure the domain type

After you add a domain to your Exchange Online organization in the Office 365 admin center, you can configure the domain type.

Use the EAC to change the domain type

  1. In the EAC, go to Mail flow > Accepted domains.

  2. Select the domain and click Edit Edit icon.

  3. In the Accepted Domain window, in the This accepted domain is section, select the domain type. The possible values are Authoritative and Internal relay.

  • If you select Authoritative, you must confirm that you want to enable Directory Based Edge Blocking.

  • If you select Internal Relay, you can enable match subdomains to enable mail flow to all subdomains. For more information, see Enable mail flow for subdomains in Exchange Online.

  1. When you're finished, click Save.

Use Exchange Online PowerShell to change the domain type

To configure the domain type, use the following syntax:

Set-AcceptedDomain -Identity <Name> -DomainType <Authoritative | InternalRelay>

This example configures the accepted domain named contoso.com as an internal relay domain.

Set-AcceptedDomain -Identity contoso.com -DomainType InternalRelay

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

How do you know this worked?

To verify that you've successfully configured the domain type, do either of the following steps:

  • In the EAC at Mail flow > Accepted domains, click Refresh Refresh Icon. In the list of accepted domains, verify the domain type value of the accepted domain is configured correctly.

  • In Exchange Online PowerShell, run the command Get-AcceptedDomain. In the list of accepted domains, verify the domain type value of the accepted domain is configured correctly.