Connect Microsoft 365 with your own Entra ID app

Register the application yourself, choose exactly which permissions Offision gets, and hand it the credentials. For security policies that will not accept a third-party app registration.

Updated 16 Aug 2026

Most organisations should connect with application mode or delegate mode, which use Offision’s own app registration and need no credentials at all.

Use this path when that is not acceptable — when your security policy requires the application to be registered in your own Microsoft Entra ID, with permissions you choose and a secret you control and can revoke.

What to have ready

  • An app registration in Microsoft Entra ID, or the ability to create one
  • Its Directory (tenant) ID and Application (client) ID
  • A client secret value — copy it when it is created, because Microsoft will not show it again
  • Somewhere to paste two redirect URIs back into that registration
  • Half an hour, and patience with Microsoft’s permission propagation

1. Open the customize path

Open Integrations

Open the Microsoft 365 tile, choose Connect to Microsoft 365 account, then below the separator choose CustomizeBring your own Microsoft Entra ID app or customize permissions.

The wizard has two steps, listed down the left: Mode, then Credentials.

2. Choose the mode

Modes are laid out in two columns, Application and Delegated. The column decides how Offision acts against Microsoft: an application-family mode acts as the application itself, so one admin consent covers the organisation and there is no mailbox to keep alive. A delegated mode acts as a signed-in account, and reaches only what that account can reach.

FamilyModeRoom calendarsUser sign-inPeople sync
ApplicationComplete modeyesyesyes
ApplicationResource only modeyesnono
DelegatedComplete modeyesyesyes
DelegatedStandard modeyesyesno
DelegatedResource calendar modeyesnono

Functions under the matrix shows the same three capabilities for whichever mode is selected, so you can check your choice before moving on.

The mode step, with its function list and required permissions.

The mode step, with its function list and required permissions.

3. Grant the permissions the wizard lists

Below the mode matrix, Permission requirement lists exactly what that mode needs, each marked Application or Delegated — which is the kind of permission to add in Entra ID, not a detail you can ignore. Use the Copy button and send the list to whoever owns the app registration.

For the application family:

ModePermissionType
Complete modeCalendars.ReadWriteApplication
Place.Read.AllApplication
User.Read.AllApplication
Group.Read.AllApplication
openId, offline_access, email, User.ReadDelegated
Resource only modeCalendars.ReadWriteApplication
Place.Read.AllApplication
User.Read.All (optional)Application

For the delegated family:

ModePermissionType
All delegated modesCalendar.ReadWrite.SharedDelegated
openId, offline_accessDelegated
Complete mode alsoUser.Read.All, Group.Read.AllApplication

Grant admin consent for the permissions in Entra ID. Adding them is not the same as consenting to them, and a registration with permissions listed but not consented behaves exactly like one with no permissions at all.

4. Enter the credentials

Move to Credentials and fill in:

FieldWhere it comes from
Microsoft 365 service operatorMicrosoft, or 21Vianet if that is who operates your Microsoft 365
Directory (tenant) IDThe registration’s overview page. It must be a GUID
Application (client) IDThe registration’s overview page
Client secret (Value)The value of the secret, not its ID

Then copy the two redirect URIs Offision shows and add them to the app registration. Sign-in will fail later if they are missing, and the failure looks like a bad password rather than a missing URI.

The credentials step, with the redirect URIs to add in Entra ID.

The credentials step, with the redirect URIs to add in Entra ID.

5. Test the connection

On an application-family mode, use Test connection before saving. A green result means Offision could actually get a token with your credentials — which is a much better place to find a typo than three screens later.

On a delegated mode there is no Test connection button, because nothing has signed in yet and there is no token to test. Its absence is expected.

Save, then set up rooms, people and sign-in.

When it goes wrong

What you seeUsual cause
Connection failed, please check the information providedWrong tenant or client ID, a secret that has expired, or the secret’s ID pasted instead of its value
Connection failed although the credentials are rightThe permissions were added in Entra ID but admin consent was never granted
No Test connection buttonA delegated mode is selected — there is nothing to test until an account signs in
Sign-in bounces back to the login pageThe redirect URIs are not in the app registration
People never sync on delegated Complete modeUser.Read.All and Group.Read.All were granted as delegated rather than application permissions
It worked, then stopped months laterThe client secret expired. Create a new one and update the credentials
Permissions look right but calls still failMicrosoft takes five minutes to two hours to apply a permission change
Only the credentials step appearsOffision Hub, where the mode is fixed