Microsoft 365 Email

Version Latest

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.

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.

rI0u12lZ9W.gif

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.

microsoft2.png

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.

ConnectionEstablish a connection to your Microsoft 365 Email account.
Watch MessagesSelect the option to watch the messages:
  • All
  • Only Unread
  • Only Read
Mail Folder IDSelect the Folder ID whose messages you want to watch. For example, InboxArchive.
SearchEnter a keyword or a phrase to search the messages based on the specified query.
LimitSet the maximum number of messages Integromat should return during one scenario execution cycle.

Search Message

Searches for the messages.

ConnectionEstablish a connection to your Microsoft 365 Email account.
Mail Folder ID
Select the Folder ID whose messages you want to search. For example, InboxArchive.
Search
Enter a keyword or a phrase to search the messages based on the specified query.
Order BySelect 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
LimitSet the maximum number of messages Integromat should return during one scenario execution cycle.

Get a Message

Gets the metadata of a specified message.

ConnectionEstablish a connection to your Microsoft 365 Email account.
Message IDSelect the Message-ID whose details you want to retrieve.
Get Mime ContentsSelect 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.

ConnectionEstablish a connection to your Microsoft 365 Email account.
SubjectEnter the message subject line.
Body Content TypeSelect the message content-type:
  • HTML
  • Plain Text
Body ContentEnter the message text.
ImportanceSelect the message importance:
  • High
  • Medium
  • Low
To RecipientsAdd 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 RecipientsAdd 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.

ConnectionEstablish a connection to your Microsoft 365 Email account.
Message IDSelect the message you want to move to a selected folder.
Mail FolderSelect the folder to which you want to move the message.

Delete a Message

Deletes a message.

ConnectionEstablish a connection to your Microsoft 365 Email account.
Message IDSelect the message you want to delete.

Draft Message

Create a Draft Message

Creates a new draft message.

ConnectionEstablish a connection to your Microsoft 365 Email account.
SubjectEnter the message subject line.
Body Content TypeSelect the message content-type:
  • HTML
  • Plain Text
Body ContentEnter the message text.
ImportanceSelect 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.

ConnectionEstablish a connection to your Microsoft 365 Email account.
Draft MessageSelect the draft message you want to send.

Update a Message

Updates an existing message.

ConnectionEstablish a connection to your Microsoft 365 Email account.
Enter a Message IDSelect the option to choose the message:
  • Enter Manually
  • Select from the list
Folder IDSelect the Folder ID whose message you want to update.
Message IDSelect the Message ID whose details you want to update.
SubjectEnter the message subject line.
Body Content Type

Select the message content-type:

  • HTML
  • Plain Text
Body ContentEnter the message text.
ImportanceSelect 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 ReadSelect whether you want to mark this message as read.

Attachment

List Attachments

Retrieves a list of attachments to a message.

ConnectionEstablish a connection to your Microsoft 365 Email account.
Message IDSelect the Message-ID whose attachments you want to list.
LimitSet the maximum number of attachments Integromat should return during one scenario execution cycle.

Download an Attachment

Downloads an attachment to a message.

ConnectionEstablish a connection to your Microsoft 365 Email account.
Message IDSelect the Message-ID whose attachments you want to download.
Attachment IDEnter the attachment ID you want to download.

Other 

Make an API Call

Performs an arbitrary authorized API call.

ConnectionEstablish 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.

HeadersEnter the desired request headers. You don't have to add authorization headers; we already did that for you.
Query StringEnter the request query string.
BodyEnter 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

microsoftemail2.png

Matches of the search can be found in the module's Output under BundleBody > value
In our example, 5 messages were returned:

microsoftemail1.png

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

Popular use cases from our blog

automated-data-collection-crm-illustration

How to Automate Data Collection - Part 5: CRM Systems

automated-data-collection-chatbot-marketing-illustration

How to Automate Data Collection - Part 4: Chatbot Marketing

automated-data-collection-paid-ads-illustration

How to Automate Data Collection - Part 3: Paid Ads

automated-data-collection-email-illustration

How to Automate Data Collection - Part 2: Email Marketing Segmentation

personalized-customer-experience-illustration-integromat

5 Automated Solutions to Personalize Customer Experience

data-collection-automation-forms-pt-1

How to Automate Data Collection - Part 1: Online Forms

Didn’t find what you were looking for?

Expert

Find an expert

We feature a network of 450+ certified partners across the globe who are ready to help

Find an expert

Automate any workflow in your business

Sign up for a free account today. No credit card required, no time limits on free plan.