Microsoft 365 Outlook

Description

This module integrates Microsoft Outlook via Microsoft Graph API. Available operations:

• List emails: Lists emails from a specific folder (inbox, sentitems, drafts, deleteditems) with OData filters and unread-only option.
• Search emails: Searches emails by free text across the entire mailbox.
• Read email: Gets the full content of an email including HTML body, attachments, CC, BCC and conversationId. Option to mark as read.
• Send email: Sends emails with support for HTML, CC, BCC, importance, attachments (Base64) and saving to Sent Items.
• Delete email: Deletes an email by ID.
• Move email: Moves an email to another folder.
• Get attachments: Gets the list of attachments for an email with Base64 content.

Configuration

Parameter	Type	Required	Description
credentials_id	credentials	Yes	Configured Microsoft OAuth account
operation	select	Yes	Operation to perform

Sub-node Send Email

Parameter	Type	Required	Description
to	string	Yes	Recipients separated by comma
subject	string	Yes	Email subject
body	textarea	Yes	Message body
cc	string	No	CC recipients
bcc	string	No	BCC recipients
isHtml	string	No	Body is HTML (default: true)
saveToSentItems	string	No	Save to Sent Items (default: true)

Sub-node List Emails

Parameter	Type	Required	Description
folder	select	No	Folder: inbox, sentitems, drafts, deleteditems (default: inbox)
top	string	No	Maximum emails (default: 20)
filter	string	No	OData filter (e.g.: from/emailAddress/address eq ‘test@mail.com’)
unreadOnly	string	No	Unread only (true/false)

Sub-node Read Email

Parameter	Type	Required	Description
messageId	string	Yes	Message ID to read
markAsRead	string	No	Mark as read (true/false)

Sub-node Search Emails

Parameter	Type	Required	Description
searchText	string	Yes	Text to search for
top	string	No	Maximum results (default: 20)

Sub-node Delete Email

Parameter	Type	Required	Description
messageId	string	Yes	Message ID to delete

Credentials

Requires Microsoft OAuth2 type credentials with:

• Scopes: Mail.ReadWrite, Mail.Send
• The module manages token refresh automatically

Output

{
  "nextModule": "siguiente_modulo",
  "data": {
    "sendResult": {
      "success": true,
      "message": "Email enviado correctamente",
      "to": "destinatario@empresa.com",
      "subject": "Informe mensual",
      "sentAt": "2026-03-23T10:00:00Z"
    }
  },
  "_meta_": { "operation": "sendEmail", "microsoftService": "outlook" }
}

Usage Example

Basic case - Send HTML email

{
  "credentials_id": "mi-cuenta-ms365",
  "operation": "sendEmail",
  "to": "cliente@empresa.com",
  "subject": "Resumen semanal",
  "body": "<h1>Resumen</h1><p>Adjunto el informe.</p>",
  "isHtml": "true"
}

API Used

• Microsoft Graph API - Mail endpoints (/me/messages, /me/sendMail, /me/mailFolders)

Notes

• Recipients can be passed as a comma-separated string or as an array
• Attachments are sent as fileAttachment with Base64 content
• Emails are sorted by received date descending
• Search uses Microsoft Graph $search which searches in subject, body and sender
• Supports continueOnError to continue the flow on errors

Related Nodes

• MS365 Calendar - Microsoft 365 Calendar
• MS365 Teams - Teams channels, messages and meetings
• MS365 OneDrive - Files in OneDrive