Skip to main content

Connect Microsoft 365 Copilot to PAIR

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

  1. In the Microsoft Entra admin center, go to App registrations > New registration. Name it PAIR, choose single tenant, and register it.
  2. Under API permissions, add the Microsoft Graph application permissions below, then select Grant admin consent. This needs a Global Administrator or Privileged Role Administrator.
  3. Under Certificates & secrets, create a client secret and copy its Value, not the Secret ID. Microsoft displays it once.
  4. 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

  1. Open the Copilot allocation page in your organisation dashboard.
  2. Open the settings menu and select Copilot credentials.
  3. 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.

Powered by Zendesk