Skip to main content

Migrating Albert on Teams: From Graph API to Setup Policies

This article describe why you must migrate from Graph API to Setup Policies.

Updated today

Why migrate?

If you installed Albert on Microsoft Teams using the old method (Graph API permissions to push the app directly to users), you should migrate to the new setup policy-based installation.

The setup policy approach :

  • Does not require Graph API permissions or scope consent

  • Relies entirely on the Microsoft Teams Admin Center, giving your IT team full visibility and control

  • Is the officially recommended method by Microsoft for deploying Teams apps at scale

  • Makes it easier to manage which users or groups have Albert installed

Migration steps:

Option A: Organization-wide deployment

  1. In the Microsoft Teams Admin Center, go to Setup policies

  2. Select the Global (Org-wide default) policy

  3. Under Installed apps, click Add apps

  4. Search for "Albert" and select it

  5. Click Add to confirm


  6. (Optional) Add Albert to Pinned apps so it appears in users' sidebar

  7. Click Save


Option B: Targeted group deployment

  1. In Setup policies, click + Add to create a new policy


  2. Give it a name (e.g. "Albert - Sales team")

  3. Under Installed apps, click Add apps

  4. Search for and select "Albert", then confirm

  5. Click Save

  6. Go to the Group policy assignment tab


  7. Click + Add for each group you want to target

  8. Select the group and assign the policy you just created

  9. Click Apply

Did this answer your question?