Search Emails
Search email in Office 365 Mail.
Options
Field | Definition | Type | Required |
---|---|---|---|
Determines the type of user mail:
|
Dropdown |
TRUE |
|
Result Set |
Specifies the number of emails returned in the response.
Choose a method to filter search results:
|
Dropdown |
TRUE |
Search By | Specifies how to compare input text values. Searches all text fields. Choose an operator to search by:
|
Dropdown |
TRUE |
Date Filter | Specifies the date of the email in the response. Searches all text fields. Choose an operator to search by:
|
Dropdown |
TRUE |
To learn how to return a large number of records, see Stream matching records with a helper flow.
Input
Field | Definition | Type | Required |
---|---|---|---|
User | |||
User ID or Username | User ID of the email's attachment that is uploaded.
For example, john.doe@somedomain.com. This could be the user's email address, but this is not true in all cases. This property cannot contain accent characters. Only the following characters are allowed A - Z, a - z, 0 - 9, ' . - _ ! # ^ ~. Appears when User Mail is selected from the Mail option. |
Text |
TRUE |
Search | Appears when Contains is selected from the Search By option unless otherwise specified. | ||
Subject | Subject of the message.
Appears when Starts With and Contains are selected from the Search By option. |
Text |
FALSE |
Body | Body of the message. It can be in HTML or text format.
Searching the body of the message using text is supported. Searching the body of the message using HTML is not supported. Appears when Starts With and Contains are selected from the Search By option. |
Text |
FALSE |
From |
Owner of the mailbox from which the message is sent. |
Text |
FALSE |
Sender | Account that is actually used to generate the message.
Does not display when None is selected from the Search By option. |
Text |
FALSE |
Has Attachments? | True if the message has attachments; otherwise, False. To verify the existence of inline attachments, parse the body property to look for a src attribute.
For example, <IMG src="cid:image001.jpg@01D26CD8.6C05F070">. Appears when Exact Match is selected from the Search By option. This field doesn't include inline attachments. If a message contains only inline attachments, this field is False. |
True/False |
FALSE |
Importance | Importance of the message. The possible values are:
Appears when Exact Match is selected from the Search By option. |
Text |
FALSE |
Is Read? | True if the message has been read; otherwise False.
Appears when Exact Match is selected from the Search By option. |
True/False |
FALSE |
Is Draft? | True if the message is a draft (hasn't been sent); otherwise, False.
Appears when Exact Match is selected from the Search By option. |
True/False |
FALSE |
Flag Status | Status for follow-up for an item. Possible values are:
Appears when Exact Match is selected from the Search By option. |
Object |
FALSE |
Is Delivery Receipt Requested? | True if a read receipt is requested for the message; otherwise False.
Appears when Exact Match is selected from the Search By option. |
True/False |
FALSE |
Is Read Receipt Requested? | True if a read receipt is requested for the message; otherwise False.
Appears when Exact Match is selected from the Search By option. |
True/False |
FALSE |
Start Date Filter | Appears when any of the following Greater Than or Range are selected from the Date Filter option. | ||
Created Date Time |
Date and time the message was created.
For example, 2020-01-01T00:00:00Z. |
Date & Time |
FALSE |
Last Modified Date Time | Date and time the message was last changed.
For example, 2020-01-01T00:00:00Z. |
Date & Time |
FALSE |
Receive Date Time | Date and time the message was received.
For example, 2020-01-01T00:00:00Z. |
Date & Time |
FALSE |
Sent Date Time | Date and time the message was sent.
For example, 2020-01-01T00:00:00Z. |
Date & Time |
FALSE |
End Date Filter | Appears when any of the following Range or Less Than are selected from the Date Filter option. | ||
Created Date Time | Date and time the message was created.
For example, 2020-01-01T00:00:00Z. |
Date & Time |
FALSE |
Last Modified Date Time | Date and time the message was last changed.
For example, 2020-01-01T00:00:00Z. |
Date & Time |
FALSE |
Receive Date Time | Date and time the message was received.
For example, 2020-01-01T00:00:00Z. |
Date & Time |
FALSE |
Sent Date Time | Date and time the message was sent.
For example, 2014-01-01T00:00:00Z. |
Date & Time |
FALSE |
Search Criteria |
|||
Record Limit |
Specify the number of records to stream.
This field appears when you select Stream Matching Records from the Result Set option. |
Number |
FALSE |
Streaming | |||
Flow |
Click Choose Flow to browse and select a helper flow where the search results will be streamed, then click Choose to confirm. Optionally, click the empty field under Click or drop here to create and add custom extensible fields that pass data to the helper flow. These fields are added as key/value pairs under the State output object in the helper flow. |
Flow |
TRUE |
Output
Input fields that are left empty are ignored.
Field | Definition | Type |
---|---|---|
Result | Appears when First Matching Record or 200 Matching Records are selected from the Result Set option unless otherwise specified. | |
ID |
Unique ID of the message. |
Text |
Subject |
Subject of the email. |
Text |
Body Preview |
First 255 characters of the message body in text format. |
Text |
Body |
Body of the message. It can be in HTML or text format. Find out about safe HTML in a message body. |
Object |
Content Type |
Content type of the message. |
Text |
Content |
Content of the message. |
Text |
Created Date Time |
Date and time when the attachment was last created.
For example, 2020-01-01T00:00:00Z. |
Date & Time |
Last Modified Date Time |
Date and time when the attachment was last modified.
For example, 2020-01-01T00:00:00Z. |
Date & Time |
Change Key |
Version of the message. |
Text |
Categories |
Categories associated with the message. |
List of Text |
Received Date Time |
Date and time the message was received.
For example, 2020-01-01T00:00:00Z. |
Date & Time |
Sent Date Time |
Date and time the message was sent.
For example, 2020-01-01T00:00:00Z. |
Date & Time |
Has Attachments? | True if the message has attachments; otherwise, False. To verify the existence of inline attachments, parse the body property to look for a src attribute.
For example, <IMG src="cid:image001.jpg@01D26CD8.6C05F070">. This field doesn't include inline attachments. If a message contains only inline attachments, this field is False. |
True/False |
Internet Message ID |
Message ID in the format specified by RFC2822. |
Text |
Importance |
Importance of the message. The possible values are:
|
Text |
Parent Folder ID |
Unique identifier for the message's parent mail folder. |
Text |
Conversation ID |
Unique identifier to which the conversation of the email belongs. |
Text |
Conversation Index |
Indicates the position of the message within the conversation. |
Text |
Is Delivery Receipt Requested? | True if a read receipt is requested for the message; otherwise False. |
True/False |
Is Read Receipt Requested? | True if a read receipt is requested for the message; otherwise False. |
True/False |
Is Read? | True if the message has been read; otherwise False. |
True/False |
Is Draft? | True if the message is a draft and hasn't been sent; otherwise, False. |
True/False |
Web Link |
URL to open the message in Outlook on the web. You can append an ispopout argument to the end of the URL to change how the message is displayed. If ispopout is not present or if it is set to 1, then the message is shown in a popout window. If ispopout is set to 0, then the browser will show the message in the Outlook on the web review pane. The message will open in the browser if you are logged in to your mailbox via Outlook on the web. You will be prompted to login if you are not already logged in with the browser. This URL cannot be accessed from within an iFrame. |
Text |
Sender |
Account that is actually used to generate the message. In most cases, this value is the same as the from property. You can set this property to a different value when sending a message from a shared mailbox, for a shared calendar, or as a delegate. In any case, the value must correspond to the actual mailbox used. Find out more about setting the from and sender properties of a message.
In most cases, this value is the same as the From property. You can set this property to a different value when sending a message from a shared mailbox, for a shared calendar, or as a delegate. In any case, the value must correspond to the actual mailbox used. |
Object |
Email Address |
Recipient's email address. |
Object |
Name |
Name of the recipient. |
Text |
Address |
Email address of the recipient. |
Text |
From |
Email address of the sender of the email.
In most cases, this value is the same as the sender property, except for sharing or delegation scenarios. The value must correspond to the actual mailbox used. |
Object |
Email Address |
Recipient's email address. |
Object |
Name |
Name of the recipient. |
Text |
Address |
Email address of the recipient. |
Text |
To Recipients |
To: recipients for the message. |
List of Objects |
Email Address |
Recipient's email address. |
Object |
Name |
Name of the recipient. |
Text |
Address |
Email address of the recipient. |
Text |
CC Recipients |
Cc: recipients for the message. |
List of Objects |
Email Address |
Recipient's email address. |
Object |
Name |
Name of the recipient. |
Text |
Address |
Email address of the recipient. |
Text |
BCC Recipients |
Bcc: recipients for the message. |
List of Objects |
Email Address |
Recipient's email address. |
Object |
Name |
Name of the recipient. |
Text |
Address |
Email address of the recipient. |
Text |
Reply To |
Email addresses to use when replying. |
List of Text |
Flag |
Flag value that indicates the status, start date, due date, or completion date for the message. |
Text |
Attachments |
Attachment for the email. |
List of Objects |
ID |
Unique ID of the attachment. |
Text |
Name |
Name representing the text that is displayed below the icon representing the embedded attachment. This does not need to be the actual file name. |
Text |
Last Modified Date an Time |
Date and time that the attachment was modified. |
Date & Time |
Content Type |
Content type of the attachment. |
Text |
Size |
Size in bytes of the attachment. |
Number |
Is Inline? | Yes if attachment is inline; otherwise False. |
True/False |
Records Streamed |
Number of records streamed in a streaming flow. This field appears when you select Stream Matching Records from the Result Set option. |
Number |