Home > Get Started > Permissions for App Authorization

    Export to PDF

    Permissions for App Authorization

    Refer to the required API permissions listed below to add the API permissions to your custom app.

    Feature/ModuleAPIPermissionPermission typePurpose
    Calling reportMicrosoft GraphCallRecords.Read.All (Read all call records)ApplicationRead call records for all calls and online meetings.
    Teams reportMicrosoft GraphChannel.ReadBasic.All(Read the names and descriptions of all channels)ApplicationRead channel names and descriptions of Teams reporting.
    Teams reportMicrosoft GraphChannelMember.Read.All(Read the members of all channels)ApplicationRead all channel messages of the Teams reporting.
    Teams reportMicrosoft GraphChannelMessage.Read.All(Read all channel messages)ApplicationRead all channel messages of the Teams reporting.
    Teams reportMicrosoft GraphTeam.ReadBasic.All(Get a list of all teams)ApplicationRead Teams basic information of Teams reporting.
    Teams reportMicrosoft GraphTeamsTab.Read.All(Read tabs in Microsoft Teams)ApplicationRead Teams tabs of Teams reporting.
    SharePoint reportMicrosoft GraphFiles.Read.All(Read files in all site collections)ApplicationRead files in all site collections of the SharePoint reporting.
    SharePoint reportMicrosoft GraphReports.Read.All(Read all usage reports)ApplicationRead usage report data of all reporting.
    SharePoint reportMicrosoft GraphSites.Read.All(Read items in all site collections)ApplicationRead items in all site collections of the SharePoint reporting.
    Copilot adoption reportMicrosoft GraphInformationProtectionPolicy.Read.All(Read all published labels and label policies for an organization.)ApplicationRetrieve tenant sensitive labels that will be displayed in the Copilot report.
    Copilot adoption reportMicrosoft GraphAiEnterpriseInteraction.Read.All(Read all AI enterprise interactions)ApplicationRetrieve Microsoft 365 Copilot interaction data.
    Scan job basicMicrosoft GraphDirectory.Read.All(Read directory data)ApplicationRetrieve information from your organization’s Active Directory and integrate HRIS data with the Microsoft 365 data.
    Scan job basicMicrosoft GraphGroup.Read.All(Read all groups)ApplicationInventory the groups for reporting purposes.
    Scan job basicMicrosoft GraphGroupMember.Read.All(Read all group memberships)ApplicationRead group memberships of Pulse and Teams reporting.
    Scan job basicMicrosoft GraphReports.Read.All(Read all usage reports)ApplicationRead usage report data of all reporting.
    Scan job basicMicrosoft GraphUser.Read(Sign in and read user profile)DelegatedRetrieve your Microsoft 365 tenant information.
    Scan job basicMicrosoft GraphUser.Read.All(Read all users' full profiles)ApplicationRead user properties.
    Scan job basicOffice 365 Management APIsActivityFeed.Read(Read activity data for your organization)ApplicationAn aggregation of actions and events for specified content types such as Microsoft Entra, SharePoint, OneDrive, Teams, or Viva Engage.
    SharePoint reportOffice 365 SharePoint OnlineSites.Read.All(Read items in all site collections)ApplicationRead items in all site collections of the SharePoint reporting.
    SharePoint reportOffice 365 SharePoint OnlineSites.FullControl.All(Have full control of all site collections)ApplicationUsed in Sites that I own report to retrieve site owners and users with full control of sites.*Note: This permission can be removed in a custom app registration, but the Sites that I own report will not function.
    Viva Engage reportYammeraccess_as_user(Read and write to the Yammer platform [preview])DelegatedTo access the Viva Engage platform on behalf of the signed-in user.
    Viva Engage reportYammeruser_impersonation(Read and write to the Yammer platform [preview])DelegatedTo access the Viva Engage platform on behalf of the signed-in user.

    *Note: The Directory.Read.All permission can be replaced with Application.Read.All and Organization.Read.All permissions.