Skip to content
English
  • There are no suggestions because the search field is empty.

Microsoft Teams APP Admin Consent

This guide helps Microsoft Teams administrators grant tenant-wide consent for the Wellness Coach app to access necessary Microsoft Graph permissions.

 Why Admin Consent is Required & How it Helps Users

Microsoft Entra ID’s default security policy requires an administrator to approve any third-party app requesting access to chat or channel data.

Granting tenant-wide consent once removes this friction for everyone. Once approved, all users in your organization can seamlessly use the app's sharing and notification features without encountering blocker prompts.

 

Enterprise Data Security & Privacy

  • Strictly Scoped (Delegated Access): For all sharing features, the app only acts as the signed-in user and can only access data that specific user already has permission to see. It cannot read private messages outside the user's context or operate without an active session.
  • Send-Only Notifications: The single application permission used (TeamsActivity.Send) is strictly send-only. It allows the app to drop wellness reminders and challenge updates into the Teams activity feed but cannot read any messages, channels, files, or directory data.

 The Core Feature Permissions

You only need to approve the permissions for the features your organization actively intends to use:

 
 

Feature

Key Graph Permissions

Why It's Needed

How It's Triggered

  1. Channel Sharing

Team.ReadBasic.All

Channel.ReadBasic.All

ChannelMessage.Send

Lets users view their team/channel lists and share wellness content into a channel.

User-Triggered: Prompted when a user first shares to a channel.

  1. Chat Sharing

Chat.ReadBasic, ChatMessage.Send

Chat.Create, User.ReadBasic.All

Lets users find recent chats, create sharing loops, and send content via DMs/Group chats.

 

User-Triggered: Prompted when a user first shares to a chat.

  1. Push Notifications (Optional)

TeamsActivity.Send

Delivers proactive wellness reminders and session alerts directly into the Teams bell icon.

Admin-Triggered: Granted at your discretion; no user action required.

 
 
 

Note: Basic sign-in (User.Read) is classified as low-impact and is granted automatically upon a user’s first login. No admin action is required for basic access.

 How to Grant Consent via Microsoft Entra Admin Center

Administrators can proactively grant tenant-wide consent directly from the Entra portal to prevent users from seeing "Approval Required" screens.

Option A: Granting via a User's Approval Request (2 Minutes)

If a user has already attempted to use a sharing feature, they will have triggered an admin entry:

  1. Sign in to the Microsoft Entra admin center as a Global or Cloud Application Administrator.
  2. Navigate to Entra IDEnterprise appsAdmin consent requests.
  3. Click on the Wellness Coach request.
  4. Click Review permissions and consent.
  5. Critical: Check the box that says "Consent on behalf of your organization" in the Microsoft dialog, then click Accept.

Option B: Proactively Granting Consent Directly (Direct Flow)

If you want to set up the app permissions (including Optional Push Notifications) before rolling it out:

  1. Sign in to the Microsoft Entra admin center.
  2. Navigate to Entra IDEnterprise appsAll applications.
  3. Search for Wellness Coach and click to open its overview.
     
     
     
     
     
     
  4. Under the left sidebar menu, click on Permissions.
  5. Click the blue "Grant admin consent for [Your Tenant Name]" button at the top of the workspace.
  6. Review the permissions list in the Microsoft pop-up window and click Accept.
     
     

Once completed, the permissions will display under your tenant's active registry. All users can immediately leverage the approved features smoothly without any further prompts.