# Microsoft Teams + Lutril: setup guide

> Connect Microsoft Teams through Microsoft Entra admin consent so Lutril can read directory users and send proactive messages via Microsoft Graph. No secret is pasted manually; a Microsoft 365 administrator grants tenant-wide consent.

Source: https://www.lutril.com/integrations/teams
Category: Communication
Auth: oauth
Last verified: 2026-06-17

---

## Setup

1. In Lutril, open the Microsoft Teams integration and click Connect Microsoft Teams.
2. Lutril redirects you to the Microsoft Entra admin consent screen at login.microsoftonline.com.
3. Sign in as a Microsoft 365 (Entra) administrator who can grant tenant-wide consent.
4. Review the requested Microsoft Graph permissions (User.Read.All, TeamsAppInstallation.ReadWriteSelfForUser.All, offline_access) and accept.
5. Microsoft redirects you back to Lutril and the Teams connection becomes active for your tenant.

## Access requested

- https://graph.microsoft.com/User.Read.All (read the full profile of all users in the directory)
- https://graph.microsoft.com/TeamsAppInstallation.ReadWriteSelfForUser.All (install and manage the Lutril Teams app for users so they can be messaged)
- offline_access (obtain a refresh token to keep the connection active)

## References

- [Microsoft Teams documentation](https://learn.microsoft.com/en-us/graph/permissions-reference)
- [Microsoft Graph permissions reference](https://learn.microsoft.com/en-us/graph/permissions-reference)
- [Overview of Microsoft Graph permissions](https://learn.microsoft.com/en-us/graph/permissions-overview)