Connector API calls

The Microsoft 365 connector does several API calls to Microsoft Graph API and “Windows Azure Active Directory Module for Windows PowerShell” (MSOnline) to retrieve data. These calls are documented in the following sections.

Microsoft Graph API calls

API call

Description

URI

Microsoft Graph reference

Authentication token

Uses the POST operation to retrieve an auth token used in other Graph API calls.

https://login.microsoftonline.com/{tenant}/oauth2/v2.0/token

https://docs.microsoft.com/en-us/graph/auth-v2-service?context=graph%2Fapi%2F1.0&view=graph-rest-1.0#4-get-an-access-token

Organization

Uses the GET operation to retrieve information about O365 organization (tenant).

https://graph.microsoft.com/v1.0/organization

https://docs.microsoft.com/en-us/graph/api/organization-get?view=graph-rest-1.0&tabs=http

Users

Uses the GET operation to retrieve information about O365 users.

https://graph.microsoft.com/v1.0/users

https://docs.microsoft.com/en-us/graph/api/user-list?view=graph-rest-1.0&tabs=http

Subscribed SKU

Uses the GET operation to retrieve information about a service SKU company is subscribed to.

https://graph.microsoft.com/v1.0/subscribedSkus

https://docs.microsoft.com/en-us/graph/api/subscribedsku-list?view=graph-rest-1.0&tabs=http

User activity

Uses the GET operation to retrieve information about the user activity in the last 180 days.

https://graph.microsoft.com/v1.0/reports/getOffice365ActiveUserDetail(period='D180')

https://docs.microsoft.com/en-us/graph/api/reportroot-getoffice365activeuserdetail?view=graph-rest-1.0

MSOnline

Cmdlet function

Description

Cmdlet

MSOnline reference

Initiate connection

Attempts to initiate a connection to Azure Active Directory.

Connect-MsolService

https://docs.microsoft.com/en-us/powershell/module/msonline/connect-msolservice?view=azureadps-1.0

Get subscriptions

Gets all the subscriptions that the company has purchased.

Get-MsolSubscription

https://docs.microsoft.com/en-us/powershell/module/msonline/get-msolsubscription?view=azureadps-1.0