Platform: Outlook source connector (#343)

Author: Paul-Cornell

mint.json

@@ -456,6 +456,7 @@
                 "platform/sources/google-cloud",
                 "platform/sources/mongodb",
                 "platform/sources/onedrive",
+                "platform/sources/outlook",
                 "platform/sources/s3",
                 "platform/sources/sharepoint"
               ]

platform/connectors.mdx

@@ -17,6 +17,7 @@ The Unstructured Platform supports connecting to the following source and destin
 - [Google Cloud Storage](/platform/sources/google-cloud)
 - [MongoDB](/platform/sources/mongodb)
 - [OneDrive](/platform/sources/onedrive)
+- [Outlook](/platform/sources/outlook)
 - [S3](/platform/sources/s3)
 - [SharePoint](/platform/sources/sharepoint)
 

platform/sources/outlook.mdx

@@ -0,0 +1,26 @@
+---
+title: Outlook
+---
+
+Ingest your files into Unstructured from Outlook.
+
+You'll need:
+
+import OutlookPrerequisites from '/snippets/general-shared-text/outlook.mdx';
+
+<OutlookPrerequisites />
+
+To create the source connector:
+
+1. On the sidebar, click **Connectors**.
+2. Click **Sources**.
+3. Click **Add new**.
+4. Give the connector some unique **Name**.
+5. In the **Provider** area, click **Outlook**.
+6. Click **Continue**. 
+7. Follow the on-screen instructions to fill in the fields as described later on this page.
+8. Click **Save and Test**.
+
+import OutlookFields from '/snippets/general-shared-text/outlook-platform.mdx';
+
+<OutlookFields />

platform/sources/overview.mdx

@@ -24,6 +24,7 @@ To create a source connector:
    - [Google Cloud Storage](/platform/sources/google-cloud)
    - [MongoDB](/platform/sources/mongodb)
    - [OneDrive](/platform/sources/onedrive)
+   - [Outlook](/platform/sources/outlook)
    - [S3](/platform/sources/s3)
    - [SharePoint](/platform/source/sharepoint)
 

snippets/general-shared-text/outlook-platform.mdx

@@ -0,0 +1,10 @@
+Fill in the following fields:
+
+- **Name** (_required_): A unique name for this connector.
+- **User Email** (_required_): The user's email address for the target Outlook account.
+- **Authentication Provider URL** (_required_): The authentication token provider URL for the Entra ID app registration. The default is `https://login.microsoftonline.com`.
+- **Tenant** (_required_): The directory (tenant) ID of the Microsoft Entra ID app registration that has access to the Outlook account.
+- **Client ID** (_required_): The application (client) ID of the Entra ID app registration.
+- **Client Credential** (_required_): The client secret for the Entra ID app registration.
+- **Folders** (_required_): A list of top-level folder names to access in the Outlook account. Separate multiple folder names by commas. Do not specify any subfolder names.
+- **Recursive**: Check this box to access any and all subfolders within each of the specified top-level folders.

snippets/general-shared-text/outlook.mdx

@@ -12,7 +12,7 @@ allowfullscreen
 
 - The Outlook user's email address.
 - A Microsoft Entra ID app registration in the same Azure account as the Outlook account. You will need 
-  this app registration's client (application) ID, client secret, and directory (tenant) ID. [Learn how](https://learn.microsoft.com/entra/identity-platform/quickstart-register-app).
+  this app registration's application (client) ID, client secret, and directory (tenant) ID. [Learn how](https://learn.microsoft.com/entra/identity-platform/quickstart-register-app).
 - The Entra ID app registration must have the following Graph API permission levels of the application (not delegated) type: 
 
   - `Mail.Read`