You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
title: UnknownIncomingEmailIntegrationError appears in server-side synchronization
3
-
description: Solves the UnknownIncomingEmailIntegrationError that occurs in a Microsoft Dynamics 365 mailbox record.
2
+
title: UnknownIncomingEmailIntegrationError logged during server-side synchronization
3
+
description: Solves the UnknownIncomingEmailIntegrationError that's logged in a Microsoft Dynamics 365 mailbox record.
4
4
ms.reviewer:
5
5
ms.date: 12/20/2024
6
6
ms.custom: sap:Email and Exchange Synchronization
7
7
---
8
-
# UnknownIncomingEmailIntegrationError appears in mailbox alerts in Microsoft Dynamics 365
8
+
# UnknownIncomingEmailIntegrationError logged in mailbox alerts in Microsoft Dynamics 365
9
9
10
-
This article provides a solution to an error that occurs within mailbox alerts in Microsoft Dynamics 365.
10
+
This article provides a solution to an `UnknownIncomingEmailIntegrationError`error code that's logged in mailbox alerts in Microsoft Dynamics 365.
11
11
12
12
_Applies to:_ Microsoft Dynamics 365
13
13
_Original KB number:_ 4471762
14
14
15
15
## Symptoms
16
16
17
-
When [viewing the alerts section](/power-platform/admin/monitor-email-processing-errors#view-alerts) within a mailbox record in Dynamics 365, you see the following message:
17
+
When [viewing the Alerts section](/power-platform/admin/monitor-email-processing-errors#view-alerts) within a mailbox record in Dynamics 365, you might see the following message:
18
18
19
19
> An unknown error occurred while receiving email through the mailbox "\<Mailbox Name>". The owner of the associated email server profile \<Profile Name> has been notified. The system will try to receive email again later.
20
20
>
21
21
> **Email Server Error Code:** Exchange server returned UnknownIncomingEmailIntegrationError -2147220956 exception.
22
22
23
23
## Cause
24
24
25
-
The error code indicates an IsvUnexpected error. It typically indicates that a custom plugin or workflow throws an error and causing the creation of the item to fail.
25
+
The error code indicates an IsvUnexpected error. It typically means that a custom plugin or workflow throws an error, causing the creation of the item to fail.
26
26
27
27
## Resolution
28
28
29
-
To solve this issue, check if any custom plugins or workflows are running synchronously when creating the record type (email, appointment, contact, or task) mentioned in the error. If a plugin or workflow is causing an error during record creation, server-side synchronization can't create the record successfully.
29
+
To solve this issue, check if any custom plugins or workflows are running synchronously when creating the record type (email, appointment, contact, or task) mentioned in the error. If a plugin or workflow causes an error during record creation, [server-side synchronization](/power-platform/admin/server-side-synchronization) can't create the record successfully.
30
30
31
-
The following steps can help you identify if there are any workflows or plugins in your organization that run during the creation of an email. Use the same steps for other entities like appointments and tasks by replacing the Entity with the appropriate record type.
31
+
The following steps can help you identify any workflows or plugins in your organization running during the email creation. These steps can also be used for other entities like appointments and tasks by replacing `Entity` with the appropriate record type.
32
32
33
33
### Workflow
34
34
@@ -42,9 +42,9 @@ The following steps can help you identify if there are any workflows or plugins
42
42
5. If the **Start when** options have the **Record is created** option selected, and the **Run this workflow in the background (recommended)** option isn't selected, this workflow might be the cause.
43
43
44
44
> [!NOTE]
45
-
> If you're troubleshooting this type of error with an Appointment, Contact, or Task, also check if the workflow is configured to run during update of that type of record.
45
+
> If you're troubleshooting this type of error with an appointment, contact, or task, also check if the workflow is configured to run during update of that type of record.
46
46
47
-
6. Select the **Process Sessions**section on the left side of the page and look for any failures related to the email that wasn't created successfully.
47
+
6. Select **Process Sessions** on the left side of the page and look for failures related to successfully created email.
48
48
49
49
### Plugin
50
50
@@ -59,7 +59,7 @@ If you're able to reproduce the issue consistently, you can try disabling the wo
59
59
60
60
|Email Server Error Code|Cause|Resolution|
61
61
|--|--|--|
62
-
|-2147220970|This warning might appear if Server-Side Synchronization attempted to retrieve emails but encountered an unexpected error. This is typically a temporary issue and the emails will be retrieved successfully on the next synchronization cycle (typically 15 minutes).|If this message does not persist on the next synchronization cycle (typically 15 minutes), this warning can be ignored. If this message persists, you can contact Microsoft Support.|
63
-
|-2147218677|This error occurs if there was an invalid email address included on the To or Cc line of the email.|Review the email message that encountered this error and verify all email addresses on the To and Cc lines are [valid email addresses](https://tools.ietf.org/html/rfc5322#section-3.4.1).|
64
-
|-2147220192|Error -2147220192 indicates the owner of the queue does not have sufficient privileges to work with the queue. The user is likely missing sufficient Read access to the Queue entity.|Verify the user's Microsoft Dynamics 365 security role has Read access to the Queue entity. Within a Microsoft Dynamics 365 security role, privileges for the Queue entity are located on the Core Records tab. <br> **NOTE**: If you verify the owner of the mailbox record has Read access to the Queue entity, check if there are other Microsoft Dynamics 365 users or queues that received the same email. You may need to verify privileges for those users as well.|
65
-
|-2147167669|This warning is logged if the owner of the mailbox record does not have a Microsoft Dynamics 365 license assigned.|Verify the owner of the mailbox has a Microsoft Dynamics 365 license assigned.<br> **NOTE**: If you verify the user does have a license, verify there are not any other Microsoft Dynamics 365 mailbox records with the same email address. If there is another mailbox with the same email address and the owner of that mailbox does not have a license, change the email address value in the other mailbox record.|
62
+
|UnknownIncomingEmailIntegrationError -2147220970|This error might occur if [server-side synchronization](/power-platform/admin/server-side-synchronization) tries to retrieve emails but receives an unexpected error. This is typically a temporary issue and the emails will be retrieved successfully on the next synchronization cycle (typically 15 minutes.)|If this message doesn't persist on the next synchronization cycle (typically 15 minutes), this warning can be ignored. If this message persists, you can contact Microsoft Support through the **Help + Support** experience in the [Power Platform admin center](https://admin.powerplatform.microsoft.com/support).|
63
+
|UnknownIncomingEmailIntegrationError -2147218677|This error occurs if an invalid email address is included on the **To** or **Cc** line of the email.|Review the email message that receives this error and verify all email addresses on the **To** and **Cc** lines are [valid email addresses](https://tools.ietf.org/html/rfc5322#section-3.4.1).|
64
+
|UnknownIncomingEmailIntegrationError -2147220192|This error indicates the owner of the queue doesn't have sufficient privileges to work with the queue. The user is likely missing sufficient **Read** access to the `Queue` entity.|Verify the user's Dynamics 365 security role has **Read** access to the `Queue` entity. Within a Dynamics 365 security role, privileges for the `Queue` entity are located on the **Core Records** tab. <br> **NOTE**: If you verify the owner of the mailbox record has **Read** access to the `Queue` entity, check if there are other Dynamics 365 users or queues that receive the same email. You might need to verify privileges for those users as well.|
65
+
|UnknownIncomingEmailIntegrationError -2147167669|This error is logged if the owner of the mailbox record doesn't have a Dynamics 365 license assigned.|Verify the owner of the mailbox has a Dynamics 365 license assigned.<br> **NOTE**: If you verify that the user has a license, verify there aren't any other Dynamics 365 mailbox records with the same email address. If there's another mailbox with the same email address and the owner of that mailbox doesn't have a license, change the email address value in the other mailbox record.|
0 commit comments