Sends email messages through Microsoft Graph, supporting plain text or HTML bodies and file attachments.
1.0.0.0 - 2025/10/20 - Initial release.
1.0.0.9 - 2026/01/20 - Fixed shared OAuthConnection lock handling.
0.0.0.12 - Node name correction.
- Register an application in Entra ID (Azure AD) with delegated or application permission
Mail.Send (and optional Mail.ReadWrite if you also use the listener).
- Grant admin consent for the selected permissions, or ensure the signed-in user has consented.
- Configure the connection with
Tenant Id, Client Id, Client Secret, and (optionally) override Scopes (default: offline_access https://graph.microsoft.com/.default).
- Set Mailbox when you need to send on behalf of a specific mailbox; leave blank to send as the authenticated user (
Me).
- When sending attachments, Base64-encode file content and supply
Attachments as an array with Name, ContentBytes, and optional ContentType (aliases FileName/Data are also accepted).
| Parameter |
Type |
Description |
Tenant Id |
String |
Entra ID tenant identifier (or common for multi-tenant). |
Client Id |
String |
Application (client) ID registered in Entra ID. |
Client Secret |
Masked |
Client secret generated for the app registration. |
Access Token |
Masked |
OAuth access token (populated after authorization). |
Refresh Token |
Masked |
OAuth refresh token (populated when returned by Microsoft). |
Scopes |
String |
OAuth scopes requested during authorization (default: offline_access https://graph.microsoft.com/.default). |
Mailbox |
String |
Optional mailbox address/UPN to send from; leave empty to use the authenticated user (Me). |
| Parameter |
Type |
Notes |
Connection |
Connection |
OAuth connection containing Graph credentials and (optionally) mailbox selection. |
Request |
IAsyncEnumerable |
Stream of email requests. Each item must include ToRecipients, Subject, Body, optional HtmlBody, and optional Attachments. |
| Return |
Type |
Notes |
Response |
Boolean |
true when all messages are sent successfully; throws if payload validation fails. |
- Sender requires
Mail.Send permission on the target mailbox; ensure the app or user has send-as rights.
- Attachments must be Base64 encoded; large files are subject to Microsoft Graph size limits.