Home Nodes Microsoft 365 Email Listener

Microsoft 365 Email Listener

Connects to an Office 365 mailbox and waits for an email in the specified folder.

Revision History

1.0.0.0 Initial release using delegated authorization.

Properties

Connection

Type: Connection Input
The Connection Property

TenantId
Type: String
The Entra ID (formerly Azure AD Tenant ID) of the organization.

ClientId
Type: String
The Application (client) ID of the registered Azure AD app.

ClientSecret
Type: String
The client secret generated in Azure AD for the application.

Scope
Type: String
The list of space-delimited OAuth scopes required for authentication.
Required scopes: User.Read Mail.ReadWrite MailboxFolder.Read offline_access

AccessToken
Type: String
A short-lived credential issued by the authorization server that grants the client application permission to access specific resources on behalf of a user.

RefreshToken
Type: String
A long-lived credential used to obtain a new access token without requiring the user to re-authenticate.

MailboxEmail
Type: String
The email address of the mailbox to be monitored. This must be the email of the user authorizing the connection.

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.

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
Provides the originating email address of the message.

Recipients

Type: Multiline Text Output
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
Contains the subject of the message being parsed.

Body

Type: Multiline Text Output
Contains the body of the message being parsed.

AttachmentName

Type: String Output
Holds the name of the attachment being parsed.

AttachmentData

Type: Multiline Text Output
Contains a byte array (byte[]) of the attachment contents.

EmailDate

Type: String Output
Contains the date at which the email was sent.

Remarks

Configuring the Node

To configure the Microsoft 365 Email Listener, you will need to register an application in your Entra (Azure AD) tenant.

  1. Get your Tenant ID

    • Log in to Azure Portal
    • Navigate to Microsoft Entra ID
    • Copy the Tenant ID from the Overview page.

  2. Register an Application

    • In Microsoft Entra ID, go to App registrations
    • Click New registration
    • Provide a name and set the redirect URI to:
      https://app.flowgear.net/r/auth
    • Set platform to Web
    • Click Register

  3. Configure API Permissions

    • After registration, go to API Permissions > Add a permission
    • Choose Microsoft Graph > Delegated permissions
    • Add the following scopes:
      • User.Read
      • Mail.ReadWrite
      • MailboxFolder.Read
      • offline_access

  4. Generate a Client Secret

    • Go to Certificates & secrets
    • Click New client secret, set an expiry, and copy the secret value.

  5. Populate Flowgear Node Properties

    • Use the Tenant ID, Client ID, and Client Secret in the corresponding fields.
    • Set the Scope field as:
      User.Read Mail.ReadWrite MailboxFolder.Read offline_access
    • Save the connection.
    • Use the Connect your account button to be redirected to the microsoft authorization page.
    • Once the connection is authorized by the user, AccessToken and RefreshToken will be automatically populated.

See Also

IMAP Watcher