> ## Documentation Index
> Fetch the complete documentation index at: https://docs.orbb.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Office 365

> Connect Microsoft 365 (Office 365) to Orbb with delegated or application Microsoft Graph permissions for read-only access to mail metadata (no message bodies) and calendar events.

## Overview

This integration allows Orbb to access your Office 365 environment using predefined permissions, simplifying the setup process by utilizing existing configurations. The integration supports both user-delegated and application permissions to fit various operational needs, focusing on secure, read-only access to ensure data security.

## Prerequisites

* An active Office 365 subscription.
* Administrative access to manage permissions.

> [!WARNING]
>
> Administrative privileges are required to configure these settings. Ensure you have the necessary permissions before proceeding.

> [!NOTE]
>
> Refer to [Microsoft's official documentation on permission scopes](https://docs.microsoft.com/en-us/graph/permissions-reference) for detailed information on configuring permissions in Office 365.

## Step-by-Step Guide

### 1. Access the Microsoft 365 Admin Center

* Navigate to the [Microsoft 365 Admin Center](https://admin.microsoft.com/).

### 2. Configure API Permissions

* Go to **Settings -> Org settings -> Services**.
* Choose **Office 365** and then select the appropriate service configurations related to API permissions.

### 3. Assign Permissions

* Under the permissions section, configure the scopes needed for Orbb:
  * For user-delegated access:
    ```text theme={"system"}
    User.Read,
    Mail.ReadBasic,
    Calendars.Read
    ```
  * For application permissions:
    ```text theme={"system"}
    User.Read.All,
    Mail.ReadBasic.All,
    Calendars.Read
    ```

### 4. Confirm Configuration

* Review and confirm that the permissions are correctly set to match the operational needs of Orbb.
* Ensure that the permissions are set to read-only to maintain data security and integrity.

> [!NOTE]
>
> **OAuth Scopes Explanation**
>
> The following OAuth scopes are used:
>
> * `User.Read`: Allows reading basic user profile.
> * `Mail.ReadBasic`: Allows the app to read email in the signed-in user's mailbox except body, previewBody, attachments and any extended properties.
> * `Calendars.Read`: Grants read-only access to the user's calendar events.
> * `User.Read.All`: Permits reading all profiles across your organization without any modifications.
>
> These scopes are carefully chosen to ensure that Orbb can operate effectively without compromising security or data integrity.

After completing these steps, your Office 365 environment will be ready to integrate with Orbb, providing efficient data access while upholding strong security measures.

## Additional Configuration

* For integrating more deeply with specific services like Outlook, SharePoint, or OneDrive, additional configurations may be required via the same Admin Center.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.