Home > Perform Microsoft Teams Migrations > Required Permissions for Microsoft Teams Migration > Source Permissions When Destination is Microsoft Teams
Export to PDFWith the Tenant Owner or Service Administrator role, you can create a Fly app profile in AvePoint Online Services > Management > App management to connect to the Microsoft 365 tenant using the Fly app.
Refer to Fly App Profile Permissions about how to create a Fly app profile and the required permissions of the Fly app profile.
With the Tenant Owner and Service Administrator role, you can create a custom app profile in AvePoint Online Services > Management > App management to connect to the Microsoft 365 tenant using a custom Azure app.
Refer to the following procedures to create a custom app profile:
Prepare a certificate in Microsoft Entra ID. Refer to Prepare a Certificate for the Custom Azure App for more information.
You can ignore this step if you have a certificate.
Create a custom Azure app in Microsoft Entra ID. Refer to Create Custom Azure Applications for more information.
Create an App Profile for a Custom Azure App in AvePoint Online Services.
After you re-authorize the app profile, you need to wait about one hour before using the app profile for your migration to refresh the token if there are permissions updated.
Refer to the following tables to add API permissions required by Microsoft Teams Migration to the custom Azure app.
| API | Permission | Type | Purpose |
|---|---|---|---|
| Microsoft Information Protection Sync Service | UnifiedPolicy.Tenant.Read (Read all unified policies of the tenant.) | Application | Only required if you want to manage the sensitivity labels of files/emails/Teams. |
| Microsoft Graph | Directory.Read.All (Read directory data) | Application | Only required if the source is multi-geo tenant. |
| Microsoft Graph | Domain.Read.All (Read domains) | Application | Retrieve the tenant domain. |
| Microsoft Graph | EduRoster.Read.All (Read the organization's roster) | Application | Only required if you want to migrate education features. Allows the app to read the structure of schools and classes in the organization's roster and education-specific information about all users to be read. |
| Microsoft Graph | EduAssignments.Read.All (Read all class assignments with grades) | Application | Only required if you want to migrate education features. Allows the app to read all class assignments with grades for all users. |
| Microsoft Graph | EduCurricula.Read.All (Read all class modules and resources) | Application | Only required if you want to migrate education features. Allows the app to read all modules and resources. |
| Microsoft Graph | RoleManagement.Read.Directory (Read all directory RBAC settings) | Application | Retrieve directory roles. |
| Microsoft Graph | Group.Read.All (Read all groups) | Application | Retrieve Microsoft 365 Groups and Group members. |
| Microsoft Graph | Group.ReadWrite.All (Read and write all groups) | Application | Only required if you use both the app profile and the service account in the source connection and the source service account is not the team owner, to automatically add the service account as the team owner. |
| Microsoft Graph | Sites.Read.All (Read items in all site collections) | Application | Retrieve channel folders and files of team sites and private channels’ site collections. |
| Microsoft Graph | User.Read.All (Read all users’ full profiles) | Application | Retrieve information of Microsoft 365 user profiles. |
| Microsoft Graph | InformationProtectionPolicy.Read.All (Read all published labels and label policies for an organization.) | Application | Only required if you want to manage the sensitivity labels of files/emails/Teams. |
| Microsoft Graph | ChannelMember.Read.All (Read the members of all channels) | Application | Retrieve private/shared channel members. |
| Microsoft Graph | ChannelMember.ReadWrite.All (Add and remove members from all channels) | Application | Only required if you use both the app profile and the service account in the source connection and the source service account is not the private/shared channel owner, to automatically add the service account as the channel owner. |
| Microsoft Graph | ChannelMessage.Read.All (Read all channel messages) | Application | Retrieve all channel messages. |
| Microsoft Graph | TeamworkTag.Read.All (Allows the app to read tags in Teams without a signed-in user) | Application | Retrieve tags. |
| Microsoft Graph | TeamMember.Read.All (Read the members of all teams) | Application | Retrieve Team members. |
| Microsoft Graph | TeamSettings.Read.All (Read all teams’ settings) | Application | Retrieve and migrate Team settings. |
| Microsoft Graph | ChannelSettings.Read.All (Read the names, descriptions, and settings of all channels) | Application | Retrieve and migrate channel settings. |
| Microsoft Graph | TeamsAppInstallation.ReadForTeam.All (Read installed Teams apps for all teams) | Application | Retrieve and migrate Team apps. |
| Microsoft Graph | TeamsTab.Read.All (Read tabs in Microsoft Teams) | Application | Retrieve and migrate Team tabs. |
| Microsoft Graph | Schedule.Read.All (Read all schedule items) | Application | Retrieve and migrate Teams Shifts app data. |
| Microsoft Graph | Reports.Read.All (Read all usage reports) | Application | Only required by tenant discovery. |
| Microsoft Graph | ReportSettings.Read.All (Read all admin report settings) | Application | Retrieve the Reports setting of the Microsoft 365 admin center. |
| Microsoft Graph | Tasks.Read.All (Read all users’ tasks and tasklist) | Application | Retrieve planners and data in planners. |
| Azure Rights Management Services | Content.SuperUser (Read all protected content for this tenant) | Application | Only required if you want to manage the sensitivity labels of files/emails/Teams. |
| Office 365 Exchange Online | Exchange.ManageAsApp (Manage Exchange As Application) | Application | Use Exchange PowerShell to retrieve mailbox permissions. |
| Office 365 Exchange Online | Full_access_as_app (Use Exchange Web Services with full access to all mailboxes) | Application | Retrieve items from all mailboxes. *Note: If you do not want to add this permission to the app, you can create an RBAC assignment for the app to only access to specified mailboxes. Refer to the option 3 in the How to Migrate Mailboxes without the ApplicationImpersonation Role? section for details. |
| SharePoint/Office 365 SharePoint Online | Sites.FullControl.All (Have full control of all site collections) | Application | Retrieve settings and permissions of team sites. |
| SharePoint/Office 365 SharePoint Online | TermStore.ReadWrite.All (Read and write managed metadata) | Application | Retrieve and migrate Managed Metadata Service. *Note: The TermStore.ReadWrite.All permission is required to migrate the term set used in the Managed Navigation. If you do not need to migrate the term set used in the Managed Navigation, you can replace the permission with TermStore.Read.All. |
For easy use, you can directly use the following commands to add required API permissions through Manifest.
| API | Permission | Type | Purpose |
|---|---|---|---|
| Microsoft Information Protection Sync Service | UnifiedPolicy.Tenant.Read (Read all unified policies of the tenant.) | Application | Only required if you want to manage the sensitivity labels of files/emails/Teams. |
| Microsoft Graph | Domain.Read.All (Read domains) | Application | Retrieve the tenant domain. |
| Microsoft Graph | EduRoster.Read.All (Read the organization's roster) | Application | Only required if you want to migrate education features. Allows the app to read the structure of schools and classes in the organization's roster and education-specific information about all users to be read. |
| Microsoft Graph | EduAssignments.Read.All (Read all class assignments with grades) | Application | Only required if you want to migrate education features. Allows the app to read all class assignments with grades for all users. |
| Microsoft Graph | EduCurricula.Read.All (Read all class modules and resources) | Application | Only required if you want to migrate education features. Allows the app to read all modules and resources. |
| Microsoft Graph | RoleManagement.Read.Directory (Read all directory RBAC settings) | Application | Retrieve directory roles. |
| Microsoft Graph | Group.Read.All (Read all groups) | Application | Retrieve Microsoft 365 Groups and Group members. |
| Microsoft Graph | Group.ReadWrite.All (Read and write all groups) | Application | Only required if you use both the app profile and the service account in the source connection and the source service account is not the Team owner, to automatically add the service account as the Team owner. |
| Microsoft Graph | Sites.Read.All (Read items in all site collections) | Application | Retrieve channel folders and files of team sites and private channels’ site collections. |
| Microsoft Graph | User.Read.All (Read all users’ full profiles) | Application | Retrieve information of Microsoft 365 user profiles. |
| Microsoft Graph | InformationProtectionPolicy.Read.All (Read all published labels and label policies for an organization.) | Application | Only required if you want to manage the sensitivity labels of files/emails/Teams. |
| Microsoft Graph | ChannelMember.Read.All (Read the members of all channels) | Application | Retrieve private/shared channel members. |
| Microsoft Graph | ChannelMember.ReadWrite.All (Add and remove members from all channels) | Application | Only required if you use both the app profile and the service account in the source connection and the source service account is not the private/shared channel owner, to automatically add the service account as the channel owner. |
| Microsoft Graph | ChannelMessage.Read.All (Read all channel messages) | Application | Retrieve all channel messages. |
| Microsoft Graph | TeamMember.Read.All (Read the members of all teams) | Application | Retrieve Team members. |
| Microsoft Graph | TeamSettings.Read.All (Read all teams’ settings) | Application | Retrieve and migrate Team settings. |
| Microsoft Graph | ChannelSettings.Read.All (Read the names, descriptions, and settings of all channels) | Application | Retrieve and migrate channel settings. |
| Microsoft Graph | TeamsAppInstallation.ReadForTeam.All (Read installed Teams apps for all teams) | Application | Retrieve and migrate Team apps. |
| Microsoft Graph | TeamsTab.Read.All (Read tabs in Microsoft Teams) | Application | Retrieve and migrate Team tabs. |
| Microsoft Graph | Reports.Read.All (Read all usage reports) | Application | Only required by tenant discovery. |
| Microsoft Graph | ReportSettings.Read.All (Read all admin report settings) | Application | Retrieve the Reports setting of the Microsoft 365 admin center. |
| Microsoft Graph | Tasks.Read.All (Read all users’ tasks and tasklist) | Application | Retrieve planners and data in planners. |
| Microsoft Graph | TeamworkTag.Read.All (Allows the app to read tags in Teams without a signed-in user) | Application | Retrieve tags. |
| Azure Rights Management Services | Content.SuperUser (Read all protected content for this tenant) | Application | Only required if you want to manage the sensitivity labels of files/emails/Teams. |
| Office 365 Exchange Online | Exchange.ManageAsApp (Manage Exchange As Application) | Application | Use Exchange PowerShell to retrieve mailbox permissions. |
| Office 365 Exchange Online | Full_access_as_app (Use Exchange Web Services with full access to all mailboxes) | Application | Retrieve items from all mailboxes. *Note: If you do not want to add this permission to the app, you can create an RBAC assignment for the app to only access to specified mailboxes. Refer to the option 3 in the How to Migrate Mailboxes without the ApplicationImpersonation Role? section for details. |
| SharePoint/Office 365 SharePoint Online | Sites.FullControl.All (Have full control of all site collections) | Application | Retrieve settings and permissions of team sites. |
| SharePoint/Office 365 SharePoint Online | TermStore.ReadWrite.All (Read and write managed metadata) | Application | Retrieve and migrate Managed Metadata Service. *Note: The TermStore.ReadWrite.All permission is required to migrate the term set used in the Managed Navigation. If you do not need to migrate the term set used in the Managed Navigation, you can replace the permission with TermStore.Read.All. |
For easy use, you can directly use the following commands to add required API permissions through Manifest.
| API | Permission | Type | Purpose |
|---|---|---|---|
| Microsoft Graph | Domain.Read.All (Read domains) | Application | Retrieve the tenant domain. |
| Microsoft Graph | EduRoster.Read.All (Read the organization's roster) | Application | Only required if you want to migrate education features. Allows the app to read the structure of schools and classes in the organization's roster and education-specific information about all users to be read. |
| Microsoft Graph | EduAssignments.Read.All (Read all class assignments with grades) | Application | Only required if you want to migrate education features. Allows the app to read all class assignments with grades for all users. |
| Microsoft Graph | EduCurricula.Read.All (Read all class modules and resources) | Application | Only required if you want to migrate education features. Allows the app to read all modules and resources. |
| Microsoft Graph | RoleManagement.Read.Directory (Read all directory RBAC settings) | Application | Retrieve directory roles. |
| Microsoft Graph | Group.Read.All (Read all groups) | Application | Retrieve Microsoft 365 Groups and Group members. |
| Microsoft Graph | Group.ReadWrite.All (Read and write all groups) | Application | Only required if you use both the app profile and the service account in the source connection and the source service account is not the Team owner, to automatically add the service account as the Team owner. |
| Microsoft Graph | Sites.ReadWrite.All (Read items in all site collections) | Application | Retrieve channel folders and files of team sites and private channels’ site collections. |
| Microsoft Graph | User.Read.All (Read all users’ full profiles) | Application | Retrieve information of Microsoft 365 user profiles. |
| Microsoft Graph | ChannelMember.Read.All (Read the members of all channels) | Application | Retrieve private/shared channel members. |
| Microsoft Graph | ChannelMember.ReadWrite.All (Add and remove members from all channels) | Application | Only required if you use both the app profile and the service account in the source connection and the source service account is not the private/shared channel owner, to automatically add the service account as the channel owner. |
| Microsoft Graph | ChannelMessage.Read.All (Read all channel messages) | Application | Retrieve all channel messages. |
| Microsoft Graph | TeamworkTag.Read.All (Allows the app to read tags in Teams without a signed-in user) | Application | Retrieve tags. |
| Microsoft Graph | TeamMember.Read.All (Read the members of all teams) | Application | Retrieve Team members. |
| Microsoft Graph | TeamSettings.Read.All (Read all teams’ settings) | Application | Retrieve and migrate Team settings. |
| Microsoft Graph | TeamsAppInstallation.ReadForTeam.All (Read installed Teams apps for all teams) | Application | Retrieve and migrate Team apps. |
| Microsoft Graph | TeamsTab.Read.All (Read tabs in Microsoft Teams) | Application | Retrieve and migrate Team tabs. |
| Office 365 Exchange Online | Exchange.ManageAsApp (Manage Exchange As Application) | Application | Use Exchange PowerShell to retrieve mailbox permissions. |
| Office 365 Exchange Online | Full_access_as_app (Use Exchange Web Services with full access to all mailboxes) | Application | Retrieve items from all mailboxes. *Note: If you do not want to add this permission to the app, you can create an RBAC assignment for the app to only access to specified mailboxes. Refer to the option 3 in the How to Migrate Mailboxes without the ApplicationImpersonation Role? section for details. |
| SharePoint/Office 365 SharePoint Online | Sites.FullControl.All (Have full control of all site collections) | Application | Retrieve settings and permissions of team sites. |
| SharePoint/Office 365 SharePoint Online | TermStore.ReadWrite.All (Read and write managed metadata) | Application | Retrieve and migrate Managed Metadata Service. *Note: The TermStore.ReadWrite.All permission is required to migrate the term set used in the Managed Navigation. If you do not need to migrate the term set used in the Managed Navigation, you can replace the permission with TermStore.Read.All. |
For easy use, you can directly use the following commands to add required API permissions through Manifest.
If you only use service account authentication for source Teams, the service account must meet the following requirements:
Users with Multi-Factor Authentication (MFA) enabled cannot be used as the service account to perform migrations. You can use a delegated app profile instead.
Additionally, Microsoft has updated API permissions for Microsoft Teams migration. Once the old permissions are deprecated, you can use a delegated app profile to migrate conversations and other Teams data.
Licenses for Exchange Online and Microsoft Teams
To assign the licenses to the service account, go to the Microsoft 365 admin center > Users > Active users, and select Exchange Online and Microsoft Teams under the Licenses and apps tab of the service account.
Team owner of source Teams, and channel owner of source private/shared channels
You can manually add the service account as the team/channel owner. For easy use, if you grant Teams Administrator or Global Administrator for the service account, Fly can automatically add the service account as the team/channel owner as well as the owner and member of the Microsoft 365 Group associated with the Team.
After the migration, you can remove the service account from the group owner using PowerShell or block the service account directly. To remove the account, refer to Remove the Service Account for details. To block the account, go to Microsoft 365 Admin Center > Users and click the display name of the user. Click the Block this user icon, select Block the user from signing in, and save the changes.
If you want to migrate team sites of source Teams/private channels/shared channels, the service account must be Site Collection Administrator of the team sites/private channel sites/shared channel sites.
If the service account is SharePoint Administrator or Global Administrator, the service account will be automatically added as Site Collection Administrator of the team sites during the full migration job. After the migration, you can remove the service account from the team sites.
Additionally, if you want to migrate the Managed Metadata Service of source team sites, the service account must be Term Store Administrator of the Managed Metadata Service.
If the source Team is created based on a team site of classic experience, and your source connection only has the service account configured, the source service account must be Site Collection Administrator of the source site. You can also grant the SharePoint Administrator role for the service account, and Fly will automatically add the source service account as Site Collection Administrator of the source site during the migration.
If you want to migrate channel tabs and your source connection only has the service account configured, the source service account must be the Teams Administrator.
Service account pool is no longer available in migrations. If you have used the service account pool for the source before, and you want to continue using the service account pool, you can select multiple service accounts when creating Teams connections, and make sure all selected service accounts meet the requirements mentioned above.
What permissions are required if I also use an app profile?
If you use both service account and app profile authentications for source Teams, the service account must meet the following requirements:
Users with Multi-Factor Authentication (MFA) enabled cannot be used as the service account to perform migrations. You can use a delegated app profile instead.
Licenses for Exchange Online and Microsoft Teams
To assign the licenses to the service account, go to the Microsoft 365 admin center > Users > Active users, and select Exchange Online and Microsoft Teams under the Licenses and apps tab of the service account.
Team owner of source Teams, and channel owner of source private/shared channels
You can manually add the service account as the team/channel owner. For easy use, if you provide both a service account and app profile using the default Fly app or custom app with required permissions, Fly can automatically add the service account as the team/channel owner as well as the owner and member of the Microsoft 365 Group associated with the Team.
After the migration, you can block the service account directly. To block the account, go to Microsoft 365 Admin Center > Users and click the display name of the user. Click the Block this user icon, select Block the user from signing in, and save the changes.
If you want to migrate team sites of source Teams/private channels/shared channels, the service account must be Site Collection Administrator of the team sites.
With the app profile, the service account will be automatically added as Site Collection Administrator of the team sites during the full migration job. After the migration, you can remove the service account from the team sites.
Additionally, if you want to migrate the Managed Metadata Service of source team sites, the service account must be Term Store Administrator of the Managed Metadata Service.
If the source Team is created based on a team site of classic experience, and your source connection only has the service account configured, the source service account must be Site Collection Administrator of the source site. You can also grant the SharePoint Administrator role for the service account, and Fly will automatically add the source service account as Site Collection Administrator of the source site during the migration.
Service account pool is no longer available in migrations. If you have used the service account pool for the source before, and you want to continue using the service account pool, you can select multiple service accounts when creating Teams connections, and make sure all selected service accounts meet the requirements mentioned above.
Fly allows you to use the Fly delegated app profile or custom delegated app profile to connect to your workspace.
The license and permission requirements for the consent user are the same as those for the service account. For details, refer to Service Account Permissions.
If the consent user of the delegated app profile has Multi-Factor Authentication (MFA) enabled, you must authorize or re-authorize the delegated app profile after MFA is enabled. Otherwise, the migration jobs using the delegated app profile will fail.
If you re-authorize the app profile, you need to wait about one hour before using the app profile for your migration to refresh the token when there are permissions updated.
To use the Fly delegated app profile with required permissions, refer to Fly Delegated App Profile Permissions.
To use a custom delegated app profile with required permissions, refer to the following steps:
After registering an app in Microsoft Entra ID, add the required permissions to the app. The following sections show the required permissions of different tenants.
Click Authentication in the left navigation of the app.
Click Add a platform.
Select Web in the Configure platforms panel.
In the Configure Web panel, enter the AvePoint Online Services URL: https://www.avepointonlineservices.com for your commercial environment or https://usgov.avepointonlineservices.com for your U.S. Government environment in the Redirect URIs field.
Select the Access tokens and ID tokens checkboxes in the Implicit grant and hybrid flows field.

Click Configure.
Click Save.
Create an app profile for the app using the Custom mode in AvePoint Online Services by referring to Consent to a Custom Azure App with Delegated Permissions.
When consenting to the app, if you have granted the admin consent and allowed public client flows for the permissions, you can choose to use the Global Administrator consent or the User consent method. If not, you can only use the Global Administrator consent method.
Make sure the custom delegated app has the following permissions.
| API | Permission | Type | Purpose |
|---|---|---|---|
| Microsoft Information Protection Sync Service | UnifiedPolicy.User.Read (Read all unified policies a user has access to) | Delegated | Only required if you want to manage the sensitivity labels of files/emails/Teams. |
| Azure Rights Management Services | user_impersonation (Create and access protected content for users) | Delegated | Only required if you want to manage the sensitivity labels of files/emails/Teams. |
| SharePoint | AllSites.FullControl (Have full control of all site collections) | Delegated | Retrieve settings and permissions of team sites. |
| SharePoint | TermStore.Read.All (Read managed metadata) | Delegated | Retrieve and migrate Managed Metadata Service. |
| Office 365 Exchange Online | EWS.AccessAsUser.All (Access mailboxes as the signed-in user via Exchange Web Services) | Delegated | Access mailboxes as the signed-in user via Exchange Web Services |
| Office 365 Exchange Online | Exchange.Manage (Manage Exchange configuration) | Delegated | Use Exchange PowerShell to retrieve mailbox permissions. |
| Microsoft Graph | Directory.Read.All (Read directory data) | Delegated | Only required if the source is a multi-geo tenant. |
| Microsoft Graph | Domain.Read.All (Read domains) | Delegated | Retrieve the tenant domain. |
| Microsoft Graph | EduRoster.Read (Read users' view of the roster) | Delegated | Only required if you want to migrate education features. Allows the app to read the structure of schools and classes in an organization's roster and education-specific information about users to be read. |
| Microsoft Graph | EduAssignments.Read (Read users' class assignments and their grades) | Delegated | Only required if you want to migrate education features. Allows the app to read assignments and their grades. |
| Microsoft Graph | EduCurricula.Read (Read the user's class modules and resources) | Delegated | Only required if you want to migrate education features. Allows the app to read the user's modules and resources. |
| Microsoft Graph | Notes.Read.All (Read all OneNote notebooks that user can access) | Delegated | Only required if you want to migrate education features. Allows the app to read OneNote notebooks. |
| Microsoft Graph | RoleManagement.Read.Directory (Read directory RBAC settings) | Delegated | Retrieve directory roles. |
| Microsoft Graph | Group.Read.All (Read all groups) | Delegated | Retrieve Microsoft 365 Groups and Group members. |
| Microsoft Graph | Group.ReadWrite.All (Read and write all groups) | Delegated | Required if you only use the delegated app profile and the source consent user is not the Team owner to automatically add the consent user as the Team owner. |
| Microsoft Graph | Sites.Read.All (Read items in all site collections) | Delegated | Retrieve channel folders and files of team sites and private channels’ site collections. |
| Microsoft Graph | User.Read.All (Read all users’ full profiles) | Delegated | Retrieve information of Microsoft 365 user profiles. |
| Microsoft Graph | ChannelMember.Read.All (Read the members of all channels) | Delegated | Retrieve private/shared channel members. |
| Microsoft Graph | ChannelMember.ReadWrite.All (Add and remove members from all channels) | Delegated | Only required the source consent user is not the private/shared channel owner to automatically add the consent user as the channel owner. |
| Microsoft Graph | ChannelMessage.Read.All (Read all channel messages) | Delegated | Retrieve all channel messages. |
| Microsoft Graph | TeamworkTag.Read (Allows the app to read tags in Teams without a signed-in user) | Delegated | Retrieve tags. |
For easy use, you can directly use the following commands to add required API permissions through Manifest.
Make sure the custom delegated app profile has the following permissions.
| API | Permission | Type | Purpose |
|---|---|---|---|
| Microsoft Information Protection Sync Service | UnifiedPolicy.User.Read (Read all unified policies a user has access to) | Delegated | Only required if you want to manage the sensitivity labels of files/emails/Teams. |
| Azure Rights Management Services | user_impersonation (Create and access protected content for users) | Delegated | Only required if you want to manage the sensitivity labels of files/emails/Teams. |
| SharePoint | AllSites.FullControl (Have full control of all site collections) | Delegated | Retrieve settings and permissions of team sites. |
| SharePoint | TermStore.Read.All (Read managed metadata) | Delegated | Retrieve and migrate Managed Metadata Service. |
| Office 365 Exchange Online | EWS.AccessAsUser.All (Access mailboxes as the signed-in user via Exchange Web Services) | Delegated | Access mailboxes as the signed-in user via Exchange Web Services |
| Office 365 Exchange Online | Exchange.Manage (Manage Exchange configuration) | Delegated | Use Exchange PowerShell to retrieve mailbox permissions. |
| Microsoft Graph | Domain.Read.All (Read domains) | Delegated | Retrieve the tenant domain. |
| Microsoft Graph | EduRoster.Read (Read users' view of the roster) | Delegated | Only required if you want to migrate education features. Allows the app to read the structure of schools and classes in an organization's roster and education-specific information about users to be read. |
| Microsoft Graph | EduAssignments.Read (Read users' class assignments and their grades) | Delegated | Only required if you want to migrate education features. Allows the app to read assignments and their grades. |
| Microsoft Graph | EduCurricula.Read (Read the user's class modules and resources) | Delegated | Only required if you want to migrate education features. Allows the app to read the user's modules and resources. |
| Microsoft Graph | Notes.Read.All (Read all OneNote notebooks that user can access) | Delegated | Only required if you want to migrate education features. Allows the app to read OneNote notebooks. |
| Microsoft Graph | RoleManagement.Read.Directory (Read directory RBAC settings) | Delegated | Retrieve directory roles. |
| Microsoft Graph | Group.Read.All (Read all groups) | Delegated | Retrieve Microsoft 365 Groups and Group members. |
| Microsoft Graph | Group.ReadWrite.All (Read and write all groups) | Delegated | Required if you only use the delegated app profile and the source consent user is not the Team owner to automatically add the consent user as the Team owner. |
| Microsoft Graph | Sites.Read.All (Read items in all site collections) | Delegated | Retrieve channel folders and files of team sites and private channels’ site collections. |
| Microsoft Graph | User.Read.All (Read all users’ full profiles) | Delegated | Retrieve information of Microsoft 365 user profiles. |
| Microsoft Graph | ChannelMember.Read.All (Read the members of all channels) | Delegated | Retrieve private/shared channel members. |
| Microsoft Graph | ChannelMember.ReadWrite.All (Add and remove members from all channels) | Delegated | Only required if the source consent user is not the private/shared channel owner to automatically add the consent user as the channel owner. |
| Microsoft Graph | ChannelMessage.Read.All (Read all channel messages) | Delegated | Retrieve all channel messages. |
| Microsoft Graph | TeamworkTag.Read (Allows the app to read tags in Teams without a signed-in user) | Delegated | Retrieve tags. |
For easy use, you can directly use the following commands to add required API permissions through Manifest.
Make sure the custom delegated app profile has the following permissions.
| API | Permission | Type | Purpose |
|---|---|---|---|
| Microsoft Information Protection Sync Service | UnifiedPolicy.User.Read (Read all unified policies a user has access to) | Delegated | Only required if you want to manage the sensitivity labels of files/emails/Teams. |
| Microsoft Rights Management Services | user_impersonation (Create and access protected content for users) | Delegated | Only required if you want to manage the sensitivity labels of files/emails/Teams. |
| SharePoint | AllSites.FullControl (Have full control of all site collections) | Delegated | Retrieve settings and permissions of team sites. |
| SharePoint | TermStore.Read.All (Read managed metadata) | Delegated | Retrieve and migrate Managed Metadata Service. |
| Office 365 Exchange Online | EWS.AccessAsUser.All (Access mailboxes as the signed-in user via Exchange Web Services) | Delegated | Access mailboxes as the signed-in user via Exchange Web Services |
| Microsoft Graph | Domain.Read.All (Read domains) | Delegated | Retrieve the tenant domain. |
| Microsoft Graph | EduRoster.Read (Read users' view of the roster) | Delegated | Only required if you want to migrate education features. Allows the app to read the structure of schools and classes in an organization's roster and education-specific information about users to be read. |
| Microsoft Graph | EduAssignments.Read (Read users' class assignments and their grades) | Delegated | Only required if you want to migrate education features. Allows the app to read assignments and their grades. |
| Microsoft Graph | EduCurricula.Read (Read the user's class modules and resources) | Delegated | Only required if you want to migrate education features. Allows the app to read the user's modules and resources. |
| Microsoft Graph | Notes.Read.All (Read all OneNote notebooks that user can access) | Delegated | Only required if you want to migrate education features. Allows the app to read OneNote notebooks. |
| Microsoft Graph | RoleManagement.Read.Directory (Read directory RBAC settings) | Delegated | Retrieve directory roles. |
| Microsoft Graph | Group.Read.All (Read all groups) | Delegated | Retrieve Microsoft 365 Groups and Group members. |
| Microsoft Graph | Group.ReadWrite.All (Read and write all groups) | Delegated | Required if you only use the delegated app profile and the source consent user is not the team owner to automatically add the consent user as the team owner. |
| Microsoft Graph | Sites.Read.All (Read items in all site collections) | Delegated | Retrieve channel folders and files of team sites and private channels’ site collections. |
| Microsoft Graph | User.Read.All (Read all users’ full profiles) | Delegated | Retrieve information of Microsoft 365 user profiles. |
| Microsoft Graph | ChannelMember.Read.All (Read the members of all channels) | Delegated | Retrieve private/shared channel members. |
| Microsoft Graph | ChannelMember.ReadWrite.All (Add and remove members from all channels) | Delegated | Only required if the source consent user is not the private/shared channel owner to automatically add the consent user as the channel owner. |
| Microsoft Graph | ChannelMessage.Read.All (Read all channel messages) | Delegated | Retrieve all channel messages. |
| Microsoft Graph | TeamworkTag.Read (Allows the app to read tags in Teams without a signed-in user) | Delegated | Retrieve tags. |
For easy use, you can directly use the following commands to add required API permissions through Manifest.