Skip to main content

         This documentation site is for previous versions. Visit our new documentation site for current releases.      

Ensuring messages are processed before switching your email protocol to Microsoft Graph

Updated on April 6, 2022

Many organizations are transitioning to more secure email protocols, such as Microsoft Graph. Before you switch the email protocol in your Pega Platform email integration to Microsoft Graph, you must make sure that the system completely processes all your current email messages.

If you change the email protocol from IMAP or POP3 to Microsoft Graph, Microsoft Graph does not process email messages that the email listener marked as read but did not finish processing before the change.

Use the Log-Service-Email table to confirm that the system processed all in-flight email messages.

Note: Microsoft Graph does not support encryption and signing for outbound emails.
  1. In the navigation pane of Dev Studio, click App.
  2. In the search field, enter and select Log-Service-Email.
    Result: Log-Service-Email is displayed below the search field.
  3. Click Log-Service-Email to open the table.
  4. Review the Processing Status column and Error reason column for in-flight messages.
    • The status of in-flight messages is Processing in the Processing Status column.
    • In-flight messages are indicated by Message ID not found in the Error reason column.

If you switched your email protocol to Microsoft Graph before checking the Log-Service-Email table for in-flight messages, complete the following steps:

  1. Identify the unprocessed messages by reviewing the information in the Error reason column, and the time stamp at which the system last updated the messages.
  2. Open the inbox and manually mark the unprocessed messages as unread.
  3. Switch your email protocol to Microsoft Graph.

The next time the email listener wakes up, it processes the messages you marked as unread.

For more information about switching email protocols, see Configuring outbound email in Dev Studio.

What to do next: If the system processed all the email messages in your inbox, switch the email protocol to Microsoft Graph. For more information, see Configuring outbound email in Dev Studio.

Have a question? Get answers now.

Visit the Support Center to ask questions, engage in discussions, share ideas, and help others.

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best. is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us