Monitors a Microsoft Outlook inbox using Azure Active Directory and Graph API calls to trigger Flowgear integrations based on incoming email message properties.

This node requires configuration in two parts:
1 - For documentation around configuring an application to monitor email inboxes, see Configuring Azure for Microsoft Graph Email Watcher.

2 - 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.

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

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

Configuring the Required Enterprise Application

The steps to generating a certificate and configuration will be linked to here.

See Also

IMAP Watcher

Did this answer your question?