Set up Microsoft Outlook
alphaSetup guide coming soon. Microsoft Outlook has no step-by-step guide in the catalogue yet. Until it does, here is what a connection needs, and where to read more.
What a connection holds
| Field | Secret | Where it comes from |
|---|---|---|
Application (client) IDclientId | Not secret | From the Microsoft Entra admin center -> App registrations. ONE value for the whole installation, not per connected account. |
Client secretclientSecret | Secret | A client secret of the same app registration. One value for the whole installation; Entra expires them, so record the expiry. |
Access tokenaccessToken | Secret | Per connected Microsoft account, and it expires after about ONE HOUR. The host refreshes it with the refresh token. |
Refresh tokenrefreshToken | Secret | Per connected Microsoft account; issued only when the consent request includes offline_access. Every refresh answers with a NEW one -- persist it -- while the old one keeps working until it expires. |
Client stateclientState | Secret | A secret the host chooses per connected account and sends as `clientState` on every subscription. Graph echoes it inside every notification, and that echo is the ONLY thing that authenticates a delivery -- Graph does not sign them. At most 128 characters. |
Links
Microsoft Outlook API docs
Consent is requested at https://login.microsoftonline.com/common/oauth2/v2.0/authorize
React (editor surface, every host)
@particle-academy/microsoft-outlook-ui v0.2.1
