Skip to main content

Set up API Permissions for the App Registration

After you have created an app registration, you need to grant it permissions to call the Microsoft Graph and SharePoint APIs. You also need to grant the app registration an admin consent to access your organization's data.

  1. Select API permissions from the menu on the left.

  2. Select Add a permission.

    Set-up-API-Permissions-for-the-App-Registration-1-2.png

    The Request API permissions page opens with the Microsoft APIs tab activated by default.

  3. Select Microsoft Graph.

    Set-up-API-Permissions-for-the-App-Registration-3.png

  4. Select Application permissions as the type of permissions that the app registration needs to call the Microsoft Graph APIs.

    Set-up-API-Permissions-for-the-App-Registration-4.png

  5. Specify the Microsoft Graph permissions.

    1. If this is an app registration for the Tagging module only, select Sites.Selected to grant the app registration access to specific sites. You can specify the individual sites in the Administration application.

    2. If this is an app registration for the Term Store Synchronization module only, select TermStore.ReadWrite.All.

    3. If this is an app registration for both the Term Store Synchronization and the Tagging modules, select Sites.Selected and TermStore.ReadWrite.All.

    Set-up-API-Permissions-for-the-App-Registration5.png

  6. Confirm with Add permissions.

  7. Select SharePoint.

    Set-up-API-Permissions-for-the-App-Registration-7.png

  8. Select Application permissions as the type of permissions that the app registration needs to call the SharePoint APIs.

    Set-up-API-Permissions-for-the-App-Registration7.png

  9. Specify the SharePoint permissions.

    1. If this is an app registration for the Tagging module only, select Sites.Selected to grant the app registration access to specific sites. You can specify the individual sites in the Administration application.

    2. If this is an app registration for the Term Store Synchronization module only, select TermStore.ReadWrite.All, TermStore.Read.All.

      If you want to make use of the Term Store-based tagging for the Managed Metadata columns, additionally select Sites.Selected. You can specify the individual sites in the Administration application.

    3. If this is an app registration for both the Term Store Synchronization and the Tagging modules, select Sites.Selected, TermStore.ReadWrite.All and TermStore.Read.All.

    Set-up-API-Permissions-for-the-App-Registration9.png

  10. Confirm with Add permissions.

  11. Select Grant admin consent for your organization.

    Set-up-API-Permissions-for-the-App-Registration11.png

    The Grant admin consent confirmation dialog box opens.

  12. Confirm with Yes.

    The app registration can now access your organization's data.

In this section: