Merge pull request #9609 from MicrosoftDocs/DerekBraunMSFT-patch-2

AB#7299: Document Test and Enable failure causes and resolutions

Author: lucciz01

support/power-platform/dataverse/email-exchange-synchronization/test-enable-fails-for-unrecognized-email-address.md

@@ -0,0 +1,49 @@
+---
+title: Test and Enable Failed Because No User Was Found Error
+description: Explains how to resolve Test and Enable failures in Dataverse caused by unrecognized Microsoft 365 email addresses.
+ms.date: 09/10/2025
+ms.custom: sap:Email and Exchange Synchronization\Set up and configuration of server-side synchronization
+author: debrau
+ms.author: debrau
+ms.reviewer: debrau
+---
+# "Test and Enable failed because no user was found" error when configuring mailbox synchronization
+
+This article explains how to resolve the "Test and Enable failed because no user was found" error that occurs when you configure mailbox synchronization in Dataverse with Microsoft 365.
+
+## Symptoms
+
+When you attempt to [test and enable a mailbox](/power-platform/admin/connect-exchange-online#test-the-configuration-of-mailboxes) in Dataverse, you might receive the following error message:
+
+> Test and Enable failed because no user was found with the email address "`<[email protected]>`" in the Microsoft 365 tenant associated with this mailbox's Email Server Profile. Verify the user exists in [...]
+
+## Cause
+
+This error occurs if:
+
+- The specified email address doesn't exist as a User Principal Name (UPN), SMTP address, or mail address for any user in the Microsoft 365 tenant associated with the mailbox's email server profile.
+- The mailbox associated with the email address belongs to a different Microsoft 365 tenant, and a cross-tenant email server profile isn't configured.
+
+## Resolution
+
+An administrator should verify that the user exists in the correct Microsoft 365 tenant and that the email address is properly configured.
+
+To confirm the UPN, SMTP, or mail address for the user:
+
+1. Sign in to the Microsoft 365 Admin Center.
+
+2. Navigate to **Users** > **Active Users**.
+
+3. Find the intended user.
+
+4. Open the user profile and confirm the user has at least one qualifying email address matching the email address in the Dataverse mailbox record:
+
+    - **User Principal Name (UPN)** or username matches the email address.
+    - Under the **Mail** tab, select **Edit Exchange properties**. In **Manage mailboxes**, open the mailbox. On the **General** tab, confirm the **User ID** or **Email addresses** fields contain the email address.
+
+   > [!NOTE]
+   > If a matching address is found in the **Email addresses**, select **Manage email address types** to confirm the address type is **SMTP**.
+
+If the user exists in the same tenant as your Dataverse instance but doesn't have a matching UPN, SMTP, or mail address, update the Dataverse mailbox record to use a valid email address for the user.
+
+If the user doesn't exist in the same tenant as your Dataverse instance, you should [configure a cross-tenant email server profile](/power-platform/admin/connect-exchange-online-server-profile-oauth).

support/power-platform/dataverse/toc.yml

@@ -150,6 +150,8 @@
       href: email-exchange-synchronization/troubleshooting-monitoring-server-side-synchronization.md 
     - name: '"Tracked to Dynamics 365" category is added to a mailbox'
       href: email-exchange-synchronization/tracked-to-dynamics-365-category-added.md
+    - name: '"Test and Enable failed because no user was found" error'
+      href: email-exchange-synchronization/test-enable-fails-for-unrecognized-email-address.md  
     - name: Test Connection fails from Email Server Profile
       href: email-exchange-synchronization/test-connection-fails-email-server.md
     - name: '"The account does not have permission to impersonate the requested user" error'