• Documentation >
• Apps >
• Communication >
• Microsoft 365 Email

Microsoft 365 Email

The Microsoft 365 Email modules allow you to watch, create, update, send, move, and delete the messages and message attachments in your Microsoft 365 Email account.

• See the changelog for the Microsoft 365 Email App

Getting Started with Microsoft 365 Email

Prerequisites

• A Microsoft 365 Email account

In order to use Microsoft 365 Email with Ibexa Connect, it is necessary to have a Microsoft 365 Email account. If you do not have one, you can create a Microsoft 365 Email account at office.com.

Connecting Microsoft 365 Email to Ibexa Connect

1. Go to Ibexa Connect and open the Microsoft 365 Email module's Create a connection dialog.

2. In the Connection name field, enter a name for the connection and click Continue.

3. Enter your Microsoft 365 Email account login credentials and confirm the dialog by clicking Yes.

The connection has been established.

For more information about permission, see permission information for various user accounts.

Message

Watch Message

Triggers when a new message is sent or received.

Watch Messages	Select the option to watch the messages: All Only Unread Only Read
Mail Folder ID	Select the Folder ID whose messages you want to watch. For example, Inbox, Archive.
Search	Enter a keyword or a phrase to search the messages based on the specified query.
Limit	Set the maximum number of messages Ibexa Connect should return during one scenario execution cycle.

Search Message

Searches for the messages.

Mail Folder ID	Select the Folder ID whose messages you want to search. For example, Inbox, Archive.
Search	Enter a keyword or a phrase to search the messages based on the specified query.
Order By	Select the option to sort the messages: Subject - Ascending Subject - Descending Created Date Time - Ascending Created Date Time - Descending Last Modified Date Time - Ascending Last Modified Date Time - Descending Received Date Time - Ascending Received Date Time - Descending
Limit	Set the maximum number of messages Ibexa Connect should return during one scenario execution cycle.

Get a Message

Gets the metadata of a specified message.

Message ID	Select the Message-ID whose details you want to retrieve.
Get Mime Contents	Select the checkbox if you would like to receive the detail of the MIME content of the message whose details you want to retreive.

Create and Send a Message

Creates and sends a new message immediately.

Subject	Enter the message subject line.
Body Content Type	Select the message content-type: HTML Plain Text
Body Content	Enter the message text.
Importance	Select the message importance: High Medium Low
To Recipients	Add the email address to which you want to send the messages: Email Address Enter the email address of the contact. Name Enter the name of the contact.
CC Recipients	Add the email addresses which you want to add in the CC field of the email: Email Address Enter the email address of the contact. Name Enter the name of the contact.
BCC Recipients	Add the email addresses which you want to add in BCC field of the email: Email Address Enter the email address of the contact. Name Enter the name of the contact.
Attachments	Add the attachments to the email: Filename Enter the file name. For example, sample.doc Data Enter the file data to the field or map the source of the file. The maximum file size allowed is 3MB.
Internet Message Headers	Add the message headers to the email: Name Enter the header name. Value Enter the header value.

Move a Message

Moves a message to a selected folder in the mailbox.

Message ID	Select the message you want to move to a selected folder.
Mail Folder	Select the folder to which you want to move the message.

Delete a Message

Deletes a message.

Message ID	Select the message you want to delete.

Draft Message

Create a Draft Message

Creates a new draft message.

Subject	Enter the message subject line.
Body Content Type	Select the message content-type: HTML Plain Text
Body Content	Enter the message text.
Importance	Select the message importance: High Medium Low
To Recipients	Add the email address to which you want to send the messages: Email Address Enter the email address of the contact. Name Enter the name of the contact.
CC Recipients	Add the email addresses which you want to add in the CC field of the email: Email Address Enter the email address of the contact. Name Enter the name of the contact.
BCC Recipients	Add the email addresses which you want to add in the BCC field of the email: Email Address Enter the email address of the contact. Name Enter the name of the contact.
Attachments	Add the attachments to the email: Filename Enter the file name. For example, sample.doc Data Enter the file data to the field or map the source of the file. The maximum file size allowed is 3MB.
Internet Message Headers	Add the message headers to the email: Name Enter the header name. Value Enter the header value.

Send a Draft Message

Sends a draft message.

Draft Message	Select the draft message you want to send.

Update a Message

Updates an existing message.

Enter a Message ID	Select the option to choose the message: Enter Manually Select from the list
Folder ID	Select the Folder ID whose message you want to update.
Message ID	Select the Message ID whose details you want to update.
Subject	Enter the message subject line.
Body Content Type	Select the message content-type: HTML Plain Text
Body Content	Enter the message text.
Importance	Select the message importance: High Medium Low
To Recipients	Add the email address to which you want to send the messages: Email Address Enter the email address of the contact. Name Enter the name of the contact.
CC Recipients	Add the email addresses which you want to add in the CC field of the email: Email Address Enter the email address of the contact. Name Enter the name of the contact.
BCC Recipients	Add the email addresses which you want to add in the BCC field of the email: Email Address Enter the email address of the contact. Name Enter the name of the contact.
Attachments	Add the attachments to the email: Filename Enter the file name. For example, sample.doc Data Enter the file data to the field or map the source of the file. The maximum file size allowed is 3MB.
Mark it as Read	Select whether you want to mark this message as read.

Attachment

List Attachments

Retrieves a list of attachments to a message.

Message ID	Select the Message-ID whose attachments you want to list.
Limit	Set the maximum number of attachments Ibexa Connect should return during one scenario execution cycle.

Download an Attachment

Downloads an attachment to a message.

Message ID	Select the Message-ID whose attachments you want to download.
Attachment ID	Enter the attachment ID you want to download.

Other

You can call APIs using the following module.

Make an API Call

Performs an arbitrary authorized API call.

URL	Enter a path relative to https://graph.microsoft.com. For example: /v1.0/me/messages For the list of available endpoints, refer to the Microsoft 365 Email API Documentation.
Method	Select the HTTP method you want to use: GET to retrieve information for an entry. POST to create a new entry. PUT to update/replace an existing entry. PATCH to make a partial entry update. DELETE to delete an entry.
Headers	Enter the desired request headers. You don't have to add authorization headers; we already did that for you.
Query String	Enter the request query string.
Body	Enter the body content for your API call.

Example of Use - List Messages

The following API call returns all the messages from your Microsoft 36 Email account:

URL:

/v1.0/me/messages

Method:

GET

Matches of the search can be found in the module's Output under Bundle > Body > value.

In our example, 5 messages were returned:

Permissions Information or Microsoft 365 Email

• Add an Attachment - Mail.ReadWrite

• Create a Draft Message - Mail.ReadWrite

• Create and Send a Message - Mail.Send, Mail.ReadWrite

• Delete a Message - Mail.ReadWrite

• Download an Attachment - Mail.Read

• Get a Message - Mail.Read

• List Attachments - Mail.Read

• Move a Message - Mail.ReadWrite

• Search Messages - Mail.Read

• Send a Draft Message - Mail.ReadWrite

• Update a Message - Mail.ReadWrite

• Watch Messages - Mail.Read

Change log between Microsoft 365 Email [v2] and Microsoft 365 Email [v1]

• New modules - Search Messages, Get a Message, Update a Message, List Attachments, Download an Attachment, and Make an API Call ge** - Mail.ReadWrite

• Create and Send a Message - Mail.Send, Mail.ReadWrite

• Delete a Message - Mail.ReadWrite

• Download an Attachment - Mail.Read

• Get a Message - Mail.Read

• List Attachments - Mail.Read

• Move a Message - Mail.ReadWrite

• Search Messages - Mail.Read

• Send a Draft Message - Mail.ReadWrite

• Update a Message - Mail.ReadWrite

• Watch Messages - Mail.Read

Change log between Microsoft 365 Email [v2] and Microsoft 365 Email [v1]

• New modules - Search Messages, Get a Message, Update a Message, List Attachments, Download an Attachment, and Make an API Call