How to use IBM App Connect with Microsoft 365

Microsoft 365 is a cloud-based service that is designed to help meet your organization's needs for robust security, reliability, and user productivity.

  • A connector in IBM App Connect on IBM CloudCloud-managed connector Deprecated
  • A local connector in a Designer instance of IBM App Connect in containers (Continuous Delivery release)Local connector in containers (Continuous Delivery release) Deprecated
  • A local connector in a Designer instance of IBM App Connect in containers (Extended Update Support)Local connector in containers (Extended User Support release) Deprecated
  • A local connector in a Designer instance of IBM App Connect in containers (Long Term Support)Local connector in containers (Long Term Support release) Deprecated

Microsoft will fully decommission the v2.0 REST endpoint used in November 2022. In containers, Microsoft Exchange can be used as an alternative for Microsoft 365.

Connecting to Microsoft 365

Sign in to the Microsoft account that you want to use in your integration flows.

To connect to a Microsoft 365 endpoint from the App Connect Designer Catalog page for the first time, expand Microsoft 365, then click Connect. For more information about ways to connect to Microsoft 365, see Managing accounts in App Connect.


Before you use the account that is created in App Connect in a flow, rename the account to something meaningful that helps you to identify it. To rename the account on the Catalog page, select the account, open its options menu (⋮), then click Rename Account.

General considerations

Before you use App Connect Designer with Microsoft 365, take note of the following considerations:

  • (General consideration) You can see lists of the trigger events and actions that are available on the Catalog page of the App Connect Designer.

    For some applications, the events and actions in the catalog depend on the environment (IBM® Cloud Pak for Integration or App Connect on IBM Cloud) and whether the connector supports configurable events and dynamic discovery of actions. If the application supports configurable events, you see a Show more configurable events link under the events list. If the application supports dynamic discovery of actions, you see a Show more link under the actions list.

  • (General consideration) If you are using multiple accounts for an application, the set of fields that is displayed when you select an action for that application can vary for different accounts. In the flow editor, some applications always provide a curated set of static fields for an action. Other applications use dynamic discovery to retrieve the set of fields that are configured on the instance that you are connected to. For example, if you have two accounts for two instances of an application, the first account might use settings that are ready for immediate use. However, the second account might be configured with extra custom fields.

Events and actions

Microsoft 365 events

These events are for changes in this application that trigger a flow to start performing the actions in the flow.

Note: Events are not available for changes in this application. You can trigger a flow in other ways, such as at a scheduled interval or at specific dates and times.

Microsoft 365 actions

These are actions on this application that you want a flow to complete.

Create attachment
Retrieve attachments
Download message attachment
Download event attachment
Download task attachment
Create calendar
Retrieve all calendars
Retrieve calendars
Update calendar
Delete calendar
Update or create calendar
Calendar events
Create calendar event
Retrieve all calendar events
Retrieve calendar events
Update calendar event
Delete calendar event
Update or create event
Calendar groups
Create calendar group
Retrieve calendar groups
Update calendar group
Delete calendar group
Update or create calendar group
Create contact
Retrieve all contacts
Retrieve contacts
Update contact
Delete contact
Update or create contact
Contact folders
Retrieve contact folders
Retrieve all contact folders
Event attachments
Retrieve all event attachments
Mail folders
Create mail folder
Retrieve all mail folders
Retrieve mail folders
Update mail folder
Delete mail folder
Update or create mail folder
Create message
Retrieve all messages
Forward message
Copy message
Retrieve messages
Update message
Delete message
Send message on the fly
Reply to message
Update or create message
Reply all to message
Message attachments
Retrieve all message attachments
Task attachments
Retrieve all task attachments
Task folders
Retrieve all task folders
Retrieve all tasks