How to use IBM App Connect with Microsoft Exchange

Microsoft Exchange is a cloud-based service that manages your emails, contacts, and calendars.

Availability:

App Connect Enterprise as a Service connector
Local connector in containers (Long Term Support Cycle-3 release) 13.0.7.0-r1 or later
Local connector in containers (Continuous Delivery release)
Local connector in containers (Long Term Support Cycle-2 release)

Supported product and API versions

To find out which product and API versions this connector supports, see Detailed System Requirements on the IBM Support page.

Connecting to Microsoft Exchange

Complete the connection fields that you see in the App Connect Designer Connect > Applications and APIs page or flow editor. If necessary, work with your Microsoft Exchange administrator to obtain these values.

Select your preferred user type, and then fill the values for the connection fields.

Non-admin user
Admin user

Microsoft Exchange has the following connection fields.

Authorization method	Connection field	Description	Applicability
BASIC OAUTH	Access token	The access token that is generated from the application client ID and client secret.	App Connect in containers and App Connect Enterprise as a Service
	Refresh token	The refresh token that is generated from the application client ID and client secret.
	Client ID	The unique identifier generated after the Microsoft Azure app registration gets mapped to the specific project requests.
	Client secret	The application client secret for a project-specific unique application client ID.
OAUTH 2.0 AUTH CODE	Tip: Authorize connection to Microsoft Exchange by signing in to your account.		App Connect Enterprise as a Service

To obtain the connection values for Microsoft Exchange, see Obtaining connection values for Microsoft Exchange.

To connect to a Microsoft Exchange endpoint from the App Connect Designer Applications and APIs page for the first time, expand Microsoft Exchange, then click Connect.

Tip:

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 Applications and APIs page, select the account, open its options menu (⋮), then click Rename Account.

General considerations

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

(General consideration) You can see lists of the trigger events and actions that are available on the Applications and APIs page of the App Connect Designer.
For some applications, the events and actions depend on the environment 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 Exchange events

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

Show more configurable events: Events that are shown by default are pre-configured by using optimized connectivity. More items are available after you configure events that can trigger a flow by polling this application for new or updated objects. For more information about configurable events, see Configuring polled events to trigger flows.

Microsoft Exchange actions

Your flow completes these actions on this application.

Object	Action	Description
Attachments	Create attachment	Creates an attachment in Microsoft Exchange
	Delete attachment	Deletes an attachment in Microsoft Exchange
	Download attachment	Downloads an attachment from Microsoft Exchange
	Retrieve attachments	Retrieves attachments from Microsoft Exchange
Calendar groups	Create calendar group	Creates a calendar group in Microsoft Exchange
	Delete calendar group	Deletes a calendar group in Microsoft Exchange
	Retrieve calendar groups	Retrieves calendar groups from Microsoft Exchange
	Update calendar group	Updates a calendar group in Microsoft Exchange
Calendar events	Create calendar group	Creates a calendar group in Microsoft Exchange
	Delete calendar group	Deletes a calendar group in Microsoft Exchange
	Retrieve calendar groups	Retrieves calendar groups from Microsoft Exchange
	Update calendar group	Updates a calendar group in Microsoft Exchange
Calendars	Create calendar	Creates a calendar in Microsoft Exchange
	Delete calendar	Deletes a calendar in Microsoft Exchange
	Retrieve calendars	Retrieves calendar details from Microsoft Exchange
	Update calendar	Updates calendar details in Microsoft Exchange
Contact folders	Create contact folder	Creates a contact folder in Microsoft Exchange
	Delete contact folder	Deletes a contact folder in Microsoft Exchange
	Retrieve contact folders	Retrieves contact folders from Microsoft Exchange
	Update contact folder	Updates a contact folder in Microsoft Exchange
Contacts	Create contact	Creates a contact in Microsoft Exchange
	Delete contact	Deletes a contact in Microsoft Exchange
	Retrieve contacts	Retrieves contacts from Microsoft Exchange
	Update contact	Updates a contact in Microsoft Exchange
Conversations	Create conversation	Creates a conversation in Microsoft Exchange
Conversations	Retrieve conversations	Retrieves conversation details from Microsoft Exchange
Emails	Copy email	Copies an email to a folder in Microsoft Exchange
	Create draft email	Creates a draft email in Microsoft Exchange
	Delete email	Deletes an email in Microsoft Exchange
	Forward email	Forwards an email in Microsoft Exchange
	Move email	Moves an email to a folder in Microsoft Exchange
	Reply all to email	Replies all to an email in Microsoft Exchange
	Reply to email	Replies to an email in Microsoft Exchange
	Retrieve emails	Retrieves emails from Microsoft Exchange
	Send draft email	Sends a draft email in Microsoft Exchange
	Send email	Sends an email in Microsoft Exchange
	Update email	Updates an email in Microsoft Exchange
Group members	Retrieve group members	Retrieves the members of group from Microsoft Exchange
Groups	Create group	Creates operation for starter group
	Delete group	Deletes a group
	Retrieve groups	Retrieves groups
	Update group	Updates a group
Mail folders	Create mail folder	Creates a mail folder in Microsoft Exchange
	Copy mail folder	Copies a mail folder to another parent folder in Microsoft Exchange
	Delete mail folder	Deletes a mail folder in Microsoft Exchange
	Move mail folder	Moves a mail folder to another parent folder in Microsoft Exchange
	Retrieve mail folders	Retrieves mail folders from Microsoft Exchange
	Update mail folder	Updates a mail folder in Microsoft Exchange
Organizations	Retrieve organizations	Retrieves an organization
Users	Retrieve users	Retrieves users from Microsoft Exchange

Examples

Dashboard tile for a template that uses Microsoft Exchange

Use templates to quickly create flows for Microsoft Exchange

Learn how to use App Connect templates to quickly create flows that complete actions on Microsoft Exchange. For example, go to the Discover page and search for Microsoft Exchange.

Learn more

Model Context Protocol (MCP) support

The Microsoft Exchange connector supports MCP, and all Microsoft Exchange actions for the listed objects can be added to an MCP server as tools. For more information on how to configure an MCP server, see Creating and managing MCP servers.