> ## Documentation Index
> Fetch the complete documentation index at: https://domoinc-openapi-sync-dataflows.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Microsoft Exchange Connector

## Intro

<Note>
  **Note:** This connector only supports on-premise Microsoft Exchange Server only. For the Microsoft Exchange Online server, the REST connector should be used. Refer to [Basic Authentication Deprecation in Exchange](#https://techcommunity.microsoft.com/t5/exchange-team-blog/basic-authentication-deprecation-in-exchange-online-time-s-up/ba-p/3695312 "_blank"), for more details.
</Note>

Microsoft Exchange Server is a mail server and calendaring server. To learn more about the Microsoft Exchange API, visit their page ([https://docs.microsoft.com/en-us/exc...s-and-contacts](https://docs.microsoft.com/en-us/exchange/client-developer/exchange-web-services/office-365-rest-apis-for-mail-calendars-and-contacts "https://docs.microsoft.com/en-us/exchange/client-developer/exchange-web-services/office-365-rest-apis-for-mail-calendars-and-contacts") ).

You connect to your Microsoft Exchange account in the Data Center. This topic discusses the fields and menus that are specific to the Microsoft Exchange connector user interface. General information for adding DataSets, setting update schedules, and editing DataSet information is discussed in [Adding a DataSet Using a Data Connector](/s/article/360042926274).

## Prerequisites

To connect to your Microsoft Exchange account and create a DataSet, you must have the following:

* The URL for the Microsoft Exchange serveryou want to pull data from
* Your Microsoft Exchange username and password

## Connecting to Your Microsoft Exchange Account

This section enumerates the options in the **Credentials** and **Details** panes in the Microsoft Exchange Connector page. The components of the other panes in this page, **Scheduling** and **Name & Describe Your DataSet**, are universal across most connector types and are discussed in greater length in [Adding a DataSet Using a Data Connector](/s/article/360042926274 "Adding a DataSet Using a Data Connector").

### Credentials Pane

This pane contains fields for entering credentials to connect to your Microsoft Exchange account. The following table describes what is needed for each field:

<table border="1" cellpadding="1" cellspacing="1" data-aura-rendered-by="33:195;a"><thead><tr><th colspan="1" rowspan="1"><p><span class="s1"> Field </span></p></th><th colspan="1" rowspan="1"><p><span class="s1"> Description </span></p></th></tr></thead><tbody><tr><td colspan="1" rowspan="1"><p> Username </p></td><td colspan="1" rowspan="1"><p> Enter the username for your Microsoft Exchange account. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Password </p></td><td colspan="1" rowspan="1"><p> Enter the password for your Microsoft Exchange account. </p></td></tr><tr><td colspan="1" rowspan="1"><p> URL </p></td><td colspan="1" rowspan="1"><p> Enter the URL for your Microsoft Exchange server. </p></td></tr></tbody></table>

Once you have entered valid Microsoft Exchange credentials, you can use the same account any time you go to create a new Microsoft Exchange DataSet. You can manage connector accounts in the **Accounts** tab in the Data Center. For more information about this tab, see [Managing User Accounts for Connectors](/s/article/360042926054 "Managing User Accounts for Connectors").

### Details Pane

This pane contains a primary **Reports** menu, along with various other menus which may or may not appear depending on the report type you select.

<table border="1" cellpadding="1" cellspacing="1" data-aura-rendered-by="33:195;a"><thead><tr><th colspan="1" rowspan="1"><p> Menu </p></th><th colspan="1" rowspan="1"><p> Description </p></th></tr></thead><tbody><tr><td colspan="1" rowspan="1"><p> Report </p></td><td colspan="1" rowspan="1"><p> Select the Microsoft Exchange report you want to run. The following reports are available: </p><table border="1" cellpadding="1" cellspacing="1"><tbody><tr><td colspan="1" rowspan="1"><p> Attachments </p></td><td colspan="1" rowspan="1"><p> Returns parsed data from the specified email attachment. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Appointments </p></td><td colspan="1" rowspan="1"><p> Returns details of appointments, such as start time, end time, location, etc. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Messages </p></td><td colspan="1" rowspan="1"><p> Returns message details such as recipients, body, subject, size, importance, sender name, etc. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Tasks </p></td><td colspan="1" rowspan="1"><p> Returns task details such as start date, due date, subject, etc. </p></td></tr></tbody></table></td></tr><tr><td colspan="1" rowspan="1"><p> Calendar Type </p></td><td colspan="1" rowspan="1"><p> Select whether you want to import a shared or personal (<b> Own </b> ) calendar. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Shared Calendars </p></td><td colspan="1" rowspan="1"><p> Select the shared calendar(s) you want to import into Domo. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Search Type </p></td><td colspan="1" rowspan="1"><p> Select whether you want your search to bring in exact or fuzzy results. If you select <b> Exact </b>, the connector performs an exact match for the given inputs. If you select <b> Fuzzy </b>, the connector brings in search results that merely contain the given inputs. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Subject (Optional) </p></td><td colspan="1" rowspan="1"><p> Enter a subject to filter to show all emails containing the given subject line. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Folder Path (Optional) </p></td><td colspan="1" rowspan="1"><p> Enter the path of the folder containing messages you want to search. If you do not enter a folder path, the "Inbox" folder will be searched. For example, if the root folder was "DOMO" and in that root folder you had a folder called "DOMO\_TEST," you would enter the following to return messages for "DOMO\_TEST": <span class="mt-font-courier-new"> DOMO/DOMO\_TEST </span></p></td></tr><tr><td colspan="1" rowspan="1"><p> From (Optional) </p></td><td colspan="1" rowspan="1"><p> Enter the ID of a user to filter returned data specific to that user. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Start Days </p></td><td colspan="1" rowspan="1"><p> Enter the number of days back you want to begin pulling data for. For example, if you entered <span class="mt-font-courier-new"> 7 </span> here, each time the report ran it would pull data from 7 days ago up until today. </p></td></tr><tr><td colspan="1" rowspan="1"><p> File Type </p></td><td colspan="1" rowspan="1"><p> Select whether the attachment you are importing is a CSV, XLS, XLSX, JSON, or XML file. </p></td></tr><tr><td colspan="1" rowspan="1"><p> File Name </p></td><td colspan="1" rowspan="1"><p> Enter the name of the attachment you want to import. </p></td></tr><tr><td colspan="1" rowspan="1"><p> File Password (Optional) </p></td><td colspan="1" rowspan="1"><p> If the file you are uploading is password-protected, enter the password here. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Sheet Name (Optional) </p></td><td colspan="1" rowspan="1"><p> If the Excel file you are uploading is found on a specific sheet, enter the sheet name here. If you do not enter a sheet name, the first sheet of the workbook will be used. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Layout </p></td><td colspan="1" rowspan="1"><p> Select the layout of your Excel file. The following options are available: </p><ul><li><p><b><b> Column as Header </b></b>. Indicates that your Excel data uses a column-based layout (i.e. each column has a header). </p></li><li><p><b><b> Row as Header </b></b>. Indicates that your Excel data uses a row-based layout (i.e. each row has a header). </p></li><li><p><b><b> Cross Tab </b></b>. Indicates that your Excel data uses a cross-tab (pivot) layout. </p></li><li><p><b><b> Raw </b></b>. Indicates that your Excel data is raw (unformatted). </p></li></ul></td></tr><tr><td colspan="1" rowspan="1"><p> Mode </p></td><td colspan="1" rowspan="1"><p> Select how the cell range of your Excel data will be determined. If you select <b><b> Auto </b></b>, the range is determined automatically. If you select <b><b> Manual </b></b>, you will be asked to enter the column header and data ranges manually. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Column Header Range (Optional) </p></td><td colspan="1" rowspan="1"><p> Enter the range for the column headers in your Excel sheet. For example: <span class="mt-font-courier-new"> A2:F8 </span></p></td></tr><tr><td colspan="1" rowspan="1"><p> Row Header Range (Optional) </p></td><td colspan="1" rowspan="1"><p> Enter the range for the row headers in your Excel sheet. For example: <span class="mt-font-courier-new"> A2:A8 </span></p></td></tr><tr><td colspan="1" rowspan="1"><p> Data Range (Optional) </p></td><td colspan="1" rowspan="1"><p> Enter the range for the data (non-header) cells in your Excel sheet. For example: <span class="mt-font-courier-new"> A3:F20 </span></p></td></tr><tr><td colspan="1" rowspan="1"><p> Appointment Start Date </p></td><td colspan="1" rowspan="1"><p> Select whether you want to pull appointment data for a specific date or a date range. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Start Date </p></td><td colspan="1" rowspan="1"><p> Select whether you want to pull task data for a specific date or a date range. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Due Date </p></td><td colspan="1" rowspan="1"><p> Select whether you want your task due date to be for a specific date or date range. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Report Date </p></td><td colspan="1" rowspan="1"><p> Select whether the report data is for a specific date or for a relative number of days back from today. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Select Specific Date </p></td><td colspan="1" rowspan="1"><p> Select the date for the report. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Days Back </p></td><td colspan="1" rowspan="1"><p> Enter the number of past days that should appear in the report. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Start Date </p></td><td colspan="1" rowspan="1"><p> Specify whether the first date in your date range is a specific or relative date. You select the last date in your range in <b> End Date </b>. </p></td></tr><tr><td colspan="1" rowspan="1"><p> End Date </p></td><td colspan="1" rowspan="1"><p> Specify whether the second date in your date range is a specific or relative date. You select the first date in your range in <b> Start Date </b>. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Select Specific Start Date </p></td><td colspan="1" rowspan="1"><p> Select the first date in your date range. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Select Specific End Date </p></td><td colspan="1" rowspan="1"><p> Select the second date in your date range. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Days Back to Start From </p></td><td colspan="1" rowspan="1"><p> Enter the number of the farthest day back that should be represented in the report. Combine with <b> Days Back to End At </b> to create a range of represented days. </p><p> For example, if you entered <span class="mt-font-courier-new"> 10 </span> for <b> Days Back to Start From </b> and <span class="mt-font-courier-new"> 5 </span> for <b> Days Back to End At </b>, the report would contain data for 10 days ago up until 5 days ago. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Days Back to End At </p></td><td colspan="1" rowspan="1"><p> Enter the number of the most recent day back that should be represented in the report. Combine with <b> Days Back to Start From </b> to create a range of represented days. </p><p> For example, if you entered <span class="mt-font-courier-new"> 10 </span> for <b> Days Back to Start From </b> and <span class="mt-font-courier-new"> 5 </span> for <b> Days Back to End At </b>, the report would contain data for 10 days ago up until 5 days ago. </p></td></tr></tbody></table>

### Other Panes

For information about the remaining sections of the connector interface, including how to configure scheduling, retry, and update options, see [Adding a DataSet Using a Data Connector](/s/article/360042926274).
