Setup user group policies for Microsoft Teams apps

Use a Teams app setup policy to give the Leena AI app to a specific group of employees — for a pilot, a phased rollout, or when only some teams should have it — and pin it to their Teams app bar so it's easy to find.

The setup spans two Microsoft admin portals:

  • Microsoft 365 admin center — create the group of employees who should get the app.
  • Teams admin center — upload the app, grant admin consent, create the setup policy and assign it to the group.
📘

Before you start

  • Download the Leena AI app package (zip) from Admin Console → External channels → Teams. See Teams.
  • Granting admin consent (step 7) needs an account with Global Administrator privileges.

Create the user group

  1. Sign in to the Microsoft 365 admin center.
  2. Go to Teams & groups → Active teams & groups.
Microsoft 365 admin center with Teams & groups → Active teams & groups highlighted
  1. Create a new group with the employees who should get the Leena AI app, or select an existing group and update its members.
Active teams and groups list in the Microsoft 365 admin center
Searching for and selecting a group in Active teams and groups

Upload the Leena AI app

  1. Once the group has the right members, open the Teams admin center.
  2. Go to Teams apps → Manage apps, click + Upload new app, and upload the zip you downloaded from Admin Console → External channels → Teams. If you're updating an app that's already uploaded, skip to step 6.
Teams admin center Manage apps page with Upload new app highlighted
Upload a custom app dialog in the Teams admin center
  1. Updating an existing app (instead of step 5): open the app from Manage apps and click Upload file under New version to upload the new package. You get a new package each time you click Update branding on the Admin Console, and each one carries a higher version number — once the upload succeeds, the Published version shown here changes to match.
App details page with Upload file under New version and the Published version highlighted
🔗

Optional: link the uploaded app back to Leena AI

Once the app is in Teams, you can enter the app ID Teams assigned to it as External app ID on the Admin Console Teams page. Leena AI uses it to build links that open the app in Teams. See Teams.

Grant admin consent

  1. Grant the app the permissions it needs. This step needs Global Administrator privileges.

In Manage apps, search for the Leena AI app and open it.

Searching for the Leena AI app in Manage apps

Open the Permissions tab and click Review permissions and consent.

Permissions tab with the Review permissions and consent button highlighted

You're redirected to the Microsoft sign-in page. Sign in with an admin account — only an admin can grant consent on behalf of the organisation.

Microsoft Pick an account sign-in screen

Review the permissions the app requests and click Accept. The window closes once consent is granted, and you can move on to the next step.

Microsoft Permissions requested screen with Accept button

These are the Microsoft Graph permissions the Leena AI app asks for, and what each is used for:

Permission on the consent screenUsed for
Sign in and read user profileSigning employees in to the Leena AI app in Teams (single sign-on)
Maintain access to data you have given it access toRefreshing sign-in so employees stay signed in
Send a teamwork activity as the user / to any userPosting Leena AI notifications to the Teams activity feed
Read user's installed Teams apps / Read installed Teams apps for all usersChecking that the Leena AI app is installed for an employee before notifying them

Create an app setup policy

  1. Go to Teams apps → Setup policies → Manage policies and click + Add to create a new policy. This is where you add the Leena AI app.
App setup policies page with Manage policies and Add highlighted
  1. Configure the policy:
    1. Enter a Name and Description for the policy.
    2. Under Installed apps, click Add apps.
    3. Search for the Leena AI app you uploaded in step 5 and click Add next to it.
    4. Click Add at the bottom of the panel.
New app setup policy with the Add installed apps panel open
  1. Pin the Leena AI app so it appears in employees' Teams app bar:
    1. Under Pinned apps, click + Add apps.
    2. Search for the Leena AI app, click Add next to it, then click Add at the bottom of the panel.
    3. Click Save to create the policy.
Pinned apps section with Add apps highlighted
Add pinned apps panel: searching for the app, then the app listed under Apps to add

Assign the policy to the group

  1. Assign the policy to the group you created in the Microsoft 365 admin center:
    1. Go to Teams apps → Setup policies → Group policy assignment.
    2. Click + Add, search for the group, select the policy you created, and click Apply.
Group policy assignment with the Assign policy to group panel
⏱️

What employees see

Members of the group get the Leena AI app installed and pinned in Teams. Employees outside the group keep the Global (Org-wide default) policy. Policy changes aren't instant — Microsoft notes they can take up to 24 hours to reach everyone.


Did this page help you?