Microsoft Email Sender

Provides integration with Microsoft Graph for sending email messages and attachments from a Workflow.

Revision History

1.0.0.0 - Initial release.
1.0.0.9 - Improved OAuth connection handling.
0.0.0.12 - Corrected Node name.

Connection

The Connection stores the Microsoft Graph OAuth settings and, optionally, the mailbox to send from.

Property	Type	Description
Tenant Id	String	The Microsoft Entra ID tenant identifier, or common for a multi-tenant sign-in flow.
Client Id	String	The application ID from your Microsoft Entra ID app registration.
Client Secret	Masked	The client secret generated for the app registration.
Access Token	Masked	The OAuth access token returned after authorization.
Refresh Token	Masked	The OAuth refresh token used to renew access when Microsoft returns one.
Scopes	String	The OAuth scopes requested during authorization. The default is offline_access https://graph.microsoft.com/.default.
Mailbox	String	The optional mailbox address or UPN to send from. Leave this empty to use the authenticated user mailbox.

Setup Notes

1. Register an application in Microsoft Entra ID with the Mail.Send permission. Add Mail.ReadWrite only if you also use the listener Node.
2. Grant admin consent when your tenant requires it, or make sure the signed-in user has already consented to the requested permissions.
3. Configure the Connection with Tenant Id, Client Id, and Client Secret, then complete the OAuth authorization flow so Access Token and Refresh Token are populated.
4. Set Mailbox only when you need to send from a specific mailbox. Leave it empty when you want the Node to use the authenticated user mailbox.
5. Base64-encode attachment content and supply Attachments as an array of objects that include Name, ContentBytes, and, optionally, ContentType. The aliases FileName and Data are also accepted.

Methods

The Microsoft Email Sender Node exposes one method for sending one or more email messages through Microsoft Graph.

SendEmail

Sends one or more email messages by using the supplied request items.

Parameter	Type	Description
Connection	Connection	The Microsoft Graph Email Connection that contains the mailbox authorization details.
Request	Array	The email request items. Each item must include Subject, Body, and ToRecipients. Optional fields include CcRecipients, BccRecipients, HtmlBody, and Attachments.

Return	Type	Description
Response	Boolean	Returns true when all request items are sent successfully.

Usage Notes

• Separate recipient addresses in ToRecipients, CcRecipients, and BccRecipients by using commas, semicolons, or new lines.
• Set HtmlBody to true when the value in Body contains HTML markup.
• If Request contains multiple items, the Node sends one email per item.

Known Issues

• The sender requires Mail.Send permission on the target mailbox.
• Large attachments remain subject to Microsoft Graph size limits.