Office365 Get Mail retrieves an email from Microsoft Office365 based on the messageId information. This action allows you to view the subject, content, sender, recipients, and attachments of a specific email.
Technical Specifications
Email Retrieval: The email corresponding to the given messageId value is returned. The returned data type is Office365Message (One).
Parameters:
settings (Object – required): Contains Office365 connection settings. The Office365 API setting defined via Config Manager must be selected.
messageId (String – required): The unique ID of the email to be retrieved on Office365.
Data Source Compatibility:
A fixed value (Fixed Value) can be entered (e.g., AAMkAD…AAAJ).
It can be obtained from dynamic sources (Current, Action Result, Method Input).
Office365 Get Mail Application Steps
1. Adding an Action in UI Design
Go to the screen where you want to display the mail details.
Add a Button element (e.g., “Get Mail”).
Click on the button → + ADD ACTION → Office365 → Office365 Get Mail.
2. Defining Parameters
settings: Select your Office365 connection from Configuration Manager.
messageId: Enter the ID of the email you want to retrieve or link it from a dynamic source (e.g., the ID of the email selected from the “Inbox List”).
3. Using the Returned Data
The returned result is of type Office365Message. It contains:
subject: Email subject
body: Email content (HTML / text)
from: Sender information
toRecipients: Recipient list
ccRecipients / bccRecipients: CC and BCC information
attachments: Attachments
Usage Scenario: Displaying Mail Details
A user wants to see the details of an email in their inbox.
Steps:
Emails are listed in the “Inbox” list (Office365 List Mails).
The user selects an email.
The messageId value of the selected email → is sent as a parameter to the Office365 Get Mail action.
The email's subject, content, and attachments are displayed on the details screen.
Office365 Get Mail Advanced Customizations
Combination with List: List the inbox with the Office365 List Mails action, display the details of the selected email with the Office365 Get Mail action.
Attachment Management: Returned email attachments can be downloaded or previewed by the user.
Workflow Integration: For example, the content of an incoming email can be used to automatically create a Jira Issue.
Technical Risks and Controls
messageId must be entered correctly. If entered incorrectly, no result will be returned.
settings must be configured correctly. An error will occur if the Office365 API connection is incorrect.
Authorization limits: Users can only view emails they have permission to access.
