Microsoft Email Sender

Microsoft 365 mailboxes handle outbound business email, recipient delivery, and file attachments for notifications, customer communication, and operational messaging.

The Microsoft Email Sender Node sends email messages through Microsoft Graph from Workflow data. Use it when a Workflow needs to send one or more messages, optionally with attachments, from the authenticated mailbox or a configured shared mailbox.

Revision History

0.1.0.0 - Rebased the Node package version after the V2 overhaul review.
0.0.0.29 - Aligned the V2 connector contract and public help article.
1.0.0.0 - Initial release.
1.0.0.9 - Improved OAuth connection handling.
0.0.0.12 - Corrected Node name.

Connection

Use the Microsoft Graph Email Connection to authorize Microsoft Graph access and, when needed, send from a specific mailbox instead of the authenticated user mailbox.

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

• Register an application in Microsoft Entra ID with the Mail.Send permission. Add Mail.ReadWrite only if you also use the listener Node.
• Grant admin consent when your tenant requires it, or make sure the signed-in user has already consented to the requested permissions.
• 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.
• 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.
• Supply Attachments as a JSON string that contains an array of attachment objects. Each object must include Name and ContentBytes, may include ContentType, and also accepts the aliases FileName and Data.

Methods

This Node exposes one method for sending email messages through Microsoft Graph.

SendEmail

Use this method when you want a Workflow to send one or more outbound email messages from Microsoft 365 mailbox data.

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. Attachments must be a JSON string containing an array of attachment objects.

Return	Type	Description
Response	Boolean	Returns true when all request items are sent successfully. The Node preserves this boolean response contract and does not emit row-based mutation metadata.

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.
• Empty request streams are rejected as an input error.

Known Issues

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