Access required: Copilot allocation must be enabled for your PAIR organisation. Contact help@pairnow.ai if you would like access and we will enable it for your organisation.
Before you begin
You need:
- Microsoft 365 Copilot or Microsoft 365 Copilot Business licences, assigned directly to people rather than through groups
- a Microsoft 365 Global Administrator
- PAIR organisation admin access
Turn off concealed names in reports
In the Microsoft 365 admin center, go to Settings > Org settings > Services > Reports and turn off Display concealed user, group, and site names in all reports. Only a Global Administrator can change this.
PAIR can't match Copilot use to people, or manage licences, while this setting is on. This is an organisation-wide setting and affects other Microsoft 365 usage reports, not just PAIR. Check that turning it off is approved under your organisation's privacy policy.
Register an app for PAIR
- In the Microsoft Entra admin center, go to App registrations > New registration. Name it PAIR, choose single tenant, and register it.
- Under API permissions, add the Microsoft Graph application permissions below, then select Grant admin consent. This needs a Global Administrator or Privileged Role Administrator.
- Under Certificates & secrets, create a client secret and copy its Value, not the Secret ID. Microsoft displays it once.
- From Overview, copy the Directory (tenant) ID and the Application (client) ID.
| Permission | Why PAIR needs it |
|---|---|
User.Read.All |
Matches PAIR learners to Microsoft 365 accounts and reads their licences |
Reports.Read.All |
Reads Copilot usage reports |
ReportSettings.Read.All |
Checks whether report names are concealed |
LicenseAssignment.Read.All |
Reads your Copilot subscriptions and seat counts |
LicenseAssignment.ReadWrite.All |
Assigns and removes Copilot licences |
The Microsoft permission allows licence management across your tenant. PAIR uses it only to manage supported Copilot licences for people included in your allocation.
Add the credentials to PAIR
- Open the Copilot allocation page in your organisation dashboard.
- Open the settings menu and select Copilot credentials.
- Enter the tenant ID, client ID and client secret, and save.
A PAIR organisation admin completes this step. Keep the secret out of email, Teams messages and support tickets.
How PAIR protects the credentials
PAIR encrypts the credentials before storage and stores them against your PAIR organisation.
One set of credentials is held for each PAIR organisation, and saving new ones overwrites the old. You can revoke PAIR's access at any time by deleting the client secret or the app registration in Microsoft Entra.
What to expect after connecting
PAIR starts its first sync when you save, and your data usually appears within a few minutes. Automation stays off until an admin turns it on in Manage default setup.
Client secrets expire, and PAIR doesn't warn you beforehand. Note the expiry date and replace the secret before it lapses.