# Integrations: Microsoft 365

Connect Microsoft 365 once with your own app registration, then choose which module may send mail, read a mailbox or read devices.

Many companies already run on Microsoft 365. **Integrations** connects it to your workspace once, with your own Microsoft app registration, and then you decide which module may use which part of it: sending mail, reading a shared mailbox, or reading devices and people from Intune and Entra.

[Open Integrations now](/tenant/?open=settings/integrations)

## Before you start

You need someone who can create an **app registration** in the Microsoft Entra admin center. The exact steps are on the screen: open the Microsoft 365 card's connection and expand **How to set this up in Microsoft**.

## Connect Microsoft 365

1. Open **System settings**, then **Integrations**.
2. On the **Microsoft 365** card, click **Connection**.
3. Fill in:

| Field | Where it comes from |
|---|---|
| **Microsoft cloud** | **Commercial (Microsoft 365)**, or **GCC High (US Government)**. |
| **Directory (tenant) id** | Your app's Overview page in Entra. |
| **Application (client) id** | The same page. |
| **Client secret** | Certificates & secrets in Entra. Copy the value when it's shown. |

4. Click **Save**, then **Test**. It shows the app it signed in as and how many permissions Microsoft granted.

## The services

| Service | What it allows |
|---|---|
| **Send mail** | Send email as a mailbox. Your workspace's Email uses it. |
| **Read and file a mailbox** | Read, flag, move, reply to and forward messages. Never deletes. |
| **Devices (Intune)** | Read the computers and phones Intune manages. |
| **Devices (Entra)** | Read devices registered or joined in Entra. |
| **People (Entra)** | Read names, emails, job titles, departments and managers. |

Each one shows **Ready**, or **Needs a permission** with the Microsoft permission to add (then grant admin consent in Entra and click **Test** again).

## Give a service to a module

1. Under the service, pick a module in **Give it to…**.
2. For mail services, type the mailbox (or mailboxes) it may use.
3. Click **Give**.

Each grant can be **Paused**, **Resumed** or **Removed**, and shows when it was last used.

## Good to know

- **Modules never see your credentials** and reach only the services and mailboxes you give them here.
- **Client secrets expire.** Note the date: the connection stops then. Paste a new secret, click **Save** and **Test**.
- **Limit the mailboxes in Microsoft too.** Microsoft recommends an application access policy, otherwise the app could reach every mailbox.
- **Disconnect** stops everything that uses it, including email.
- **Every change** is recorded in the audit log.


Source: https://datavisions.ai/docs/system-settings/connections/integrations-microsoft-365
