Articles in this section

Microsoft 365 Email

Integromat Updated March 04, 2021 20:52

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 Integromat, 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.

The module dialog fields that are displayed in bold (in the Integromat scenario, not in this documentation article) are mandatory!

Connecting Microsoft 365 Email to Integromat

1. Go to Integromat 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.

Message

Watch Message

Triggers when a new message is sent or received.

Connection	Establish a connection to your Microsoft 365 Email account.
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 Integromat should return during one scenario execution cycle.

Search Message

Searches for the messages.

Connection	Establish a connection to your Microsoft 365 Email account.
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 Integromat should return during one scenario execution cycle.

Get a Message

Gets the metadata of a specified message.

Connection	Establish a connection to your Microsoft 365 Email account.
Message ID	Select the Message-ID whose details you want to retrieve.
Get Mime Contents	Select

Create and Send a Message

Creates and sends a new message immediately.

Connection	Establish a connection to your Microsoft 365 Email account.
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.

Connection	Establish a connection to your Microsoft 365 Email account.
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.

Connection	Establish a connection to your Microsoft 365 Email account.
Message ID	Select the message you want to delete.

Draft Message

Create a Draft Message

Creates a new draft message.

Connection	Establish a connection to your Microsoft 365 Email account.
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.

Connection	Establish a connection to your Microsoft 365 Email account.
Draft Message	Select the draft message you want to send.

Update a Message

Updates an existing message.

Connection	Establish a connection to your Microsoft 365 Email account.
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.

Connection	Establish a connection to your Microsoft 365 Email account.
Message ID	Select the Message-ID whose attachments you want to list.
Limit	Set the maximum number of attachments Integromat should return during one scenario execution cycle.

Download an Attachment

Downloads an attachment to a message.

Connection	Establish a connection to your Microsoft 365 Email account.
Message ID	Select the Message-ID whose attachments you want to download.
Attachment ID	Enter the attachment ID you want to download.

Other

Make an API Call

Performs an arbitrary authorized API call.

Connection	Establish a connection to your Microsoft 365 Email account.
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:

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

Was this article helpful?

1 out of 4 found this helpful