First time creating a connector? Read this first.
Requirements
You will need:
- 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 application (client) ID, client secret, and directory (tenant) ID. Learn how.
-
The Entra ID app registration must have the following Graph API permission levels of the application (not delegated) type:
Mail.ReadMail.ReadBasicUser.Read.All
Examples
To create an Outlook source connector, see the following examples. For more information on working with source connectors using the Unstructured API, see Source endpoints.Configuration settings
Replace the preceding placeholders as follows:The application (client) ID of the Microsoft Entra ID app registration that has access to the Outlook account.
The authentication token provider URL for the Entra ID app registration.
An array of folder names to access, for example:
["Inbox","Sent"]. Do not specify any subfolder names.Source connector only. Set to
true to access any and all subfolders within each of the specified top-level folders.Use
oauth_token and refresh_token only to authenticate with Unstructured Foundation, an Early Access product.Provides authentication for Unstructured Foundation (Early Access). Foundation processes your files once and maintains a persistent enrichment index. Every AI tool your team uses then gets persistent access to your organization’s knowledge, even without file uploads.Not supported for the Unstructured Pipelines operations.
Provides authentication for Unstructured Foundation (Early Access). Foundation processes your files once and maintains a persistent enrichment index. Every AI tool your team uses then gets persistent access to your organization’s knowledge, even without file uploads.Not supported for the Unstructured Pipelines operations.

