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.
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
- Open System settings, then Integrations.
- On the Microsoft 365 card, click Connection.
- 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. |
- 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
- Under the service, pick a module in Give it to….
- For mail services, type the mailbox (or mailboxes) it may use.
- 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.