Microsoft Graph Mail

Microsoft Mail (aka Outlook/Outlook Web Access/Exchange) is an email hosting and software service operated by Microsoft as part of its web version of Office.

Note:  There is no Discovery Schema or Content Service Connection available for MS Graph Mail

Authentication Connection

Standard Authentication Configuration

For more information see the standard Microsoft Graph Authentication Connection.

The application will require the following permissions:

  • Mail.Read (Requires admin consent)

  • Sites.Read.All (Requires admin consent)

oAuth Authentication Configuration

Use this type of authentication when you want to log in on behalf of a user. Also known as delegated permission.

Configuration Fields

  • Service URL: This should be set to : https://login.microsoftonline.com

  • Scope: These are the permissions required to access mail files. Multiple permissions are separated by a space. Default scope: mail.read

  • Tenant: The directory tenant the application plans to operate against, in GUID or domain-name format.

  • Client ID: The client id of the application.

  • Client Secret: The client secret for the application.

The application will require the following permissions (scope):

  • Mail.Read (Does NOT require admin consent)

Integration Connection

Caution:  RUNNING ERRORS: As of the 3.1.1 release, MSGraph connectors cannot rerun errored documents. We are aware of the issue, and it will be addressed in the next release.

Important:  WARNING: The Microsoft Graph APIs throttle connections that make what it considers excessive API calls. They have not shared these metrics, and they are determined dynamically based on previous usage and presumably account type. See this link for more details.

Job Configuration

Repository Configuration Fields

  • Email address: The email address of the mailbox you want to connect. Note: This is only available when using standard graph authentication.

  • Select a Format: Users can chose the mimetype for these records to be listed as either EML or Text/HTML

  • Get All Mailboxes: Checking this box will override the listed mailbox and process all mailboxes

Content Service Connection

Content Service Configuration

  • Connector ID: Give your connector a unique name

  • Description: Provide a description for this connection

  • Type: Select the Filesystem Content Service Connector

  • Keep Connection Alive: Keep this connection active

  • Keep alive in Milliseconds (300000 is 5 minutes): How long until connection expires if unused

  • Connection URL: The web address for your connection

  • Security Mode: None needed for this connection

  • Mapping Type: Choose single map or group mapping if you are using mapping for jobs

Supported Methods

  • createFile

  • createFolder

  • deleteFolder

  • deleteObjectByID

  • getFileContent

  • getObjectProperties

  • getTypes

  • listFolderItems

  • updateFile

  • updateProperties

API Keys

Microsoft Graph Mail Connector: Read=true: Write=false: MIP=false

Repo (Read) Specs

Key

Description

Data Type
mailbox Email Addresses String

format

Select a format

 

allUsers

Get All Mailboxes (will override mailbox list)

Boolean