> This page is for version 2025-09-18 (default).
> For other versions, use one of these documentation indexes:
> - 2025-09-18 (default): https://apidocs.polytomic.com/2025-09-18/llms.txt
> - 2024-02-08: https://apidocs.polytomic.com/2024-02-08/llms.txt
> - 2023-04-25: https://apidocs.polytomic.com/2023-04-25/llms.txt
> - 2022-12-12: https://apidocs.polytomic.com/2022-12-12/llms.txt
> - 2021-05-23: https://apidocs.polytomic.com/2021-05-23/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://apidocs.polytomic.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://apidocs.polytomic.com/_mcp/server.

# Microsoft Outlook 365

Supports:
* ✅ Models
* ✅ Bulk sync source
* ✅ Connection Proxy


## Connection

### Configuration
<table>
<thead>
<tr>
<th>Name</th><th>Type</th><th>Description</th><th>Required</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>auth_method</code></td>
<td><code>string</code></td>
<td style="vertical-align: top;">Authentication method<br/><br/>Accepted values: `oauth` <a href="#auth-method-oauth">↓</a>, `client_credentials` <a href="#auth-method-client-credentials">↓</a></td>
<td><code>required</code></td>
</tr>
<tr>
<td><code>auto_add_mailboxes</code></td>
<td><code>boolean</code></td>
<td style="vertical-align: top;">Automatically add new mailboxes</td>
<td><code>optional</code></td>
</tr>
<tr>
<td><code>client_id</code></td>
<td><code>string</code></td>
<td style="vertical-align: top;"></td>
<td><code>optional</code></td>
</tr>
<tr>
<td><code>client_secret</code></td>
<td><code>string</code></td>
<td style="vertical-align: top;"></td>
<td><code>optional</code></td>
</tr>
<tr>
<td><code>oauth_refresh_token</code></td>
<td><code>string</code></td>
<td style="vertical-align: top;"></td>
<td><code>optional</code></td>
</tr>
</tbody>
</table>

<table>
<thead>
<tr>
<th>Read-only property</th><th>Type</th><th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>user_email</code></td>
<td><code>string</code></td>
<td style="vertical-align: top;">Connected user's email</td>
</tr>
</tbody>
</table>

<a id="auth-method-oauth"></a>

#### `auth_method` = `oauth`

<table>
<thead>
<tr>
<th>Name</th><th>Type</th><th>Description</th><th>Required</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>additional_mailboxes</code></td>
<td><code>string</code></td>
<td style="vertical-align: top;">Shared mailboxes<br/><br/>Comma-separated shared mailbox addresses to read alongside your mailbox</td>
<td><code>optional</code></td>
</tr>
</tbody>
</table>

```json
{
  "name": "Microsoft Outlook 365 connection",
  "type": "outlook",
  "configuration": {
    "additional_mailboxes": "",
    "auth_method": "oauth",
    "auto_add_mailboxes": false,
    "client_id": "",
    "client_secret": "",
    "oauth_refresh_token": ""
  }
}
```

<a id="auth-method-client-credentials"></a>

#### `auth_method` = `client_credentials`

<table>
<thead>
<tr>
<th>Name</th><th>Type</th><th>Description</th><th>Required</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>client_credentials_client_id</code></td>
<td><code>string</code></td>
<td style="vertical-align: top;">Client ID</td>
<td><code>required</code></td>
</tr>
<tr>
<td><code>client_credentials_client_secret</code></td>
<td><code>string</code></td>
<td style="vertical-align: top;">Client secret <a href="#client-credentials-client-secret-set">↓</a></td>
<td><code>required</code></td>
</tr>
<tr>
<td><code>tenant_id</code></td>
<td><code>string</code></td>
<td style="vertical-align: top;">Directory (tenant) ID</td>
<td><code>required</code></td>
</tr>
</tbody>
</table>

```json
{
  "name": "Microsoft Outlook 365 connection",
  "type": "outlook",
  "configuration": {
    "auth_method": "client_credentials",
    "auto_add_mailboxes": false,
    "client_credentials_client_id": "eb669428-1854-4cb1-a560-403e05b8acbf",
    "client_credentials_client_secret": "ay8d5hdepz62px8lqeoakuea2ccl4rxm13i6tbyorxhu1i20kc8ruvksmzxq",
    "client_id": "",
    "client_secret": "",
    "mailboxes": [
      {
        "label": "",
        "value": ""
      }
    ],
    "oauth_refresh_token": "",
    "tenant_id": "3e03e565-ca33-4ef5-8e19-db300c655a40"
  }
}
```

<a id="client-credentials-client-secret-set"></a>

##### `client_credentials_client_secret`

When `client_credentials_client_secret` is set:

<table>
<thead>
<tr>
<th>Name</th><th>Type</th><th>Description</th><th>Required</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>mailboxes</code></td>
<td><code>array</code></td>
<td style="vertical-align: top;">Mailboxes</td>
<td><code>required</code></td>
</tr>
</tbody>
</table>



## Model Sync
### Source
#### Configuration
<table>
<thead>
<tr>
<th>Name</th><th>Type</th><th>Description</th><th>Required</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>object</code></td>
<td><code>string</code></td>
<td style="vertical-align: top;">Object</td>
<td><code>required</code></td>
</tr>
</tbody>
</table>


#### Example
```json
{
  ...
  "configuration": {
    "object": "object"
  }
}
```







## Bulk Sync
### Source
Microsoft Outlook 365 connections may be used as a bulk sync source. No additional configuration options are required.