Skip to main content

API calls for Microsoft 365

The Microsoft 365 connector makes API calls to Microsoft Graph API to retrieve data.

Authentication token​

The call uses the POST operation to retrieve an authentication token used in other Graph API calls.

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

For more information, see Microsoft Graph docs .

Users​

The call uses the GET operation to retrieve information about Microsoft 365 users. The call differs depending on how the Domains field is populated when adding the connector.

URI when populated with *: https://graph.microsoft.com/v1.0/users?$select=accountEnabled,assignedLicenses,displayName,givenName,id,mail,onPremisesImmutableId,onPremisesLastSyncDateTime,surname,userPrincipalName,userType,createdDateTime,country,department&$top=999

URI when populated with domains: https://graph.microsoft.com/v1.0/users?$select=accountEnabled,assignedLicenses,displayName,givenName,id,mail,onPremisesImmutableId,onPremisesLastSyncDateTime,surname,userPrincipalName,userType,createdDateTime,country,department&$top=999&$count=true&ConsistencyLevel=eventual&$filter=endswith(userPrincipalName,'domain1') OR endswith(userPrincipalName,'domains2') ... for all domains added

Required permission: User: User.Read.All

For more information, see Microsoft Graph docs .

Subscribed SKU​

The call uses the GET operation to retrieve information about the service SKUs that the company is subscribed to.

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

Required permission: Organization: Organization.Read.All

For more information, see Microsoft Graph docs .

User changes​

The call uses the GET operation to retrieve newly created, updated, or deleted users without having to perform a full read of the entire user collection.

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

Required permission: User: User.Read.All

For more information, see Microsoft Graph docs .

Reports​

The call uses the GET operation to retrieve information about applications activity and usage.

URI: https://graph.microsoft.com/v1.0/reports/

Required permission: Reports: Reports.Read.All

For more information, see Microsoft Graph docs .