Microsoft Graph Email Watcher
Trigger integrations based on incoming Microsoft Outlook emails.
Monitors a Microsoft Outlook inbox using Azure Active Directory and Graph API calls to trigger Flowgear integrations based on incoming email message properties.
Revision History
1.0.0.9 Initial Release
1.0.0.10 Added support for nesting folders by one level e.g. Inbox/Processed
1.0.1.0 Fixed a bug pertaining to the MonitoredFolder property
1.0.1.3 Fixed a bug pertaining to child folders.
1.0.1.5 Fixed bug where only the first 10 folders could be used.
Properties
Connection
Type: Connection Input
The Connection Property
TenantId
Type: String
The ID of the Azure Active Directory tenant
ClientId
Type: String
The Id of the enterprise application which has been registered in Azure.
MailboxEmail
Type: String
The email address of the mailbox to monitor.
MonitoredFolder
Type: String
The name of the folder which will be monitored for incoming messages.
ProcessedFolder
Type: String
The name of the folder to which messages will be moved once parsed by this connector.
ErrorFolder
Type: String
The folder to which the connector will attempt to move the messages in-case-of a parsing error.
Base64Cert
Type: Multiline Text
The base64 encoded string of your password-protected certificate in .PFX format.
CertPassword
Type: Password
The password to decrypt the abovementioned certificate.
FireMethod
Type: List
PerMessage - The connector will trigger once per email. If there are multiple attachments only the first one will be returned.
PerAttachment - The connector will trigger per attachment in the received email.
Sender
Type: String Output
The Sender Property provides the originating email address of the message.
Recipients
Type: Multiline Text Output
The Recipients Property lists all of the recipients of the incoming message. Note: the recipients and CC recipients are combined into a single list with the recipients at the top.
Subject
Type: String Output
The Subject Property contains the subject of the message being parsed.
Body
Type: Multiline Text Output
The Body Property contains the body of the message being parsed.
AttachmentName
Type: String Output
The AttachmentName Property holds the name of the attachment being parsed.
AttachmentData
Type: Multiline Text Output
The AttachmentData Property contains a byte array (byte[]) of the attachment contents.
EmailDate
Type: String Output
The EmailDate Property contains the date at which the email was sent.
Remarks
Configuring the Node
For documentation around configuring an application to monitor email inboxes, see Configuring Azure for Microsoft Graph Email Watcher.
In order to use this node on your site, specific site-level permissions must be granted.Submit a ticket to Flowgear Support requesting access to Microsoft Graph Email Watcher.
Limiting Permissions
This connector for Exchange Online uses the Microsoft Graph API and is authorized via a client certificate. As this node requires an application grant for Mail.ReadWrite which permits it to read all mailboxes and write to all mailboxes (for the mail move operation), it's very important that the access of the app is limited to specific mailboxes by following the guidance in the article below:
Limiting application permissions to specific Exchange Online mailboxes
Note that guidance for this step is also documented at Configuring Azure for Microsoft Graph Email Watcher.