MSGraph Email Poller

Overview

Need to poll emails from your Exchange server? This smart service can be used in a poller process and extract the data from the Microsoft Exchange server. Messages are stored in the Appian Document System, as well as the attachments. Meta data is stored in a database table for further processing.

This plug-in provides an alternative to sending emails to an Appian process model when inbound email integration is requested. Instead of the email being forwarded to Appian, this plug-in reads the emails directly from the Exchange mailbox using the MS Graph API as described below:

  • Reads the mailbox(including digitally signed emails) using the MS Graph API
  • Convert the email to an EML file stored as an Appian document, with attachments removed from it
  • Store all email attachments as separate Appian documents
  • Store all email metadata (subject, author, recipients, etc...) into a set of tables in the database

Key Features & Functionality

  • All information how to deploy, configure and use the smart service is in the 'MS Graph Mail Poller.pdf' document in the downloaded zip.
  • Extract the files in the ZIP and follow the instructions in the document.

Anonymous
  • If you're using Appian 25.2, there's a known library incompatibility that's resolved in the latest version. You can also try the following steps:

    1. Remove the plugin from the Admin Console.

    2. Reinstall the plugin.

    3. Delete and recreate the smart service

  • Hi Community,

    We’re facing an issue with the MS Graph Mail Poller smart service in Appian. When the process executes, it fails with the error:

    An error occurred in executing an Activity Class
    Node Name: MS Graph Mail Poller

    We've confirmed the connected system credentials are correct, and the token is valid. However, the node consistently fails without detailed explanation.

    Things we've already checked:

    • Input parameters like mailbox/folder are populated correctly.

    • Connected System connection test is successful.

    • Plugin version might be outdated(Current version - 4.2.6) , but we’re unsure if that’s the root cause.

    • No custom error message or stack trace from the node itself — just a generic execution error.

    Has anyone else encountered this issue?
    Is this likely due to plugin incompatibility, or is there a specific known limitation or fix for this error?

    Any guidance or troubleshooting steps would be appreciated.

    Thanks in advance!

  • v4.2.10 Release Notes
    • Added angus dependency because angus activation not exposed to plugin in LCP
  • v4.2.9 Release Notes
    • Upgraded the Message handler file for solving NullPointerException
  • v4.2.8 Release Notes
    • Security patch updated
  • Hello, we are trying to use "MSGraph Email Poller" for the first time, configured all the attributes in admin console and process model, however, seeing the below error. Anyone has faced before during initial setup?

    Error code: ErrorInvalidUser
    Error message: The requested user 'abc@xyz.com' is invalid.
    
    GET https://graph.microsoft.com//v1.0/users/abc@xyz.com/mailFolders/deleteditems
    SdkVersion : graph-java/v5.80.0
    
    
    404 : 
    [...]
    
    [Some information was truncated for brevity, enable debug logging for more details]

  • BCC columns will not be populated as they are hidden by the mail server on purpose. The only time you could populate them is if you are sending an email and preserving details.

    Honestly, not sure why we have these columns in a mail poller. 

  • Hello, we have the MS Graph Email Poller installed. As far as I know it has been installed correctly, it is functioning correctly for the most part. However, today I noticed that the BCC_NAMES and BCC_EMAILS columns are not being populated. Is there a specific configuration or anything that needs to be set up in order to populate those columns?

  • Hi, 

    We have several emails ending up in the exception folder, today we have 12 emails where the error in the logs is:

    2025-04-11 02:48:22,537 [Appian Work Item - 2042542 - WorkID 832 - execution00 - process 36048198 - model 1283 : UnattendedJavaActivityRequest] ERROR com.appiancs.msgraphmail.MSGraphDBHandler - Error writing mail to database
    java.lang.NullPointerException

    We would appreciate it if you could provide us with more detailed information about this error so that we can prevent emails from being sent to the exceptions folder.

    Thanks in advance

  • Seems to be solved with the release 4.2.7