--- title: "Seamless Login for 8x8 for Microsoft Teams" slug: "seamless-login-for-8x8-for-microsoft-teams" updated: 2026-05-17T16:45:21Z published: 2026-05-21T21:28:29Z canonical: "help.8x8.com/seamless-login-for-8x8-for-microsoft-teams" stale: true --- > ## Documentation Index > Fetch the complete documentation index at: https://help.8x8.com/llms.txt > Use this file to discover all available pages before exploring further. # Seamless Login for 8x8 for Microsoft Teams ## Overview Seamless Login automatically authenticates users into the 8x8 for Microsoft Teams app using their existing Microsoft Teams credentials. When users are already signed into Microsoft Teams and have an associated 8x8 account, they are automatically logged into the 8x8 integration app without additional credential entry or SSO pop-up windows. ![](https://cdn.us.document360.io/e3a59e39-abd3-4423-964c-0a4008dc5673/Images/Documentation/28888) ## Applies To - 8x8 Voice for Microsoft Teams version 4.0 or above ## What's New The Seamless Login feature replaces the previous authentication flow and provides the following improvements: - **Automatic authentication:** No manual credential entry required when already signed into Microsoft Teams - **Eliminates SSO pop-up windows:** Streamlined login experience - **Resolves SSO session expiration issues:** Previous sessions expired after 7 days requiring repeated manual re-authentication ## Prerequisites For Seamless Login to work automatically, one of the following conditions must be met: - Your 8x8 username matches your Microsoft Teams signed-in username - Your Federation ID matches your Microsoft Teams signed-in user ### Setting the Federation ID If your 8x8 username doesn't match your Microsoft Teams username, IT administrators can configure the Federation ID: 1. Log in to the 8x8 Admin Console 2. Navigate to **Users** 3. Select the user 4. Go to **Single Sign-On (SSO)** 5. Set the Federation ID to match the Microsoft Teams username ![](https://cdn.us.document360.io/e3a59e39-abd3-4423-964c-0a4008dc5673/Images/Documentation/28886) > [!NOTE] > NOTE: > > Setting the **Federation ID** is only necessary if the 8x8 and Microsoft usernames don't match. ## First-Time Setup: Permissions Consent When users first launch the updated 8x8 for Microsoft Teams app (version 4.0), they will see a one-time request for additional permissions: ![](https://cdn.us.document360.io/e3a59e39-abd3-4423-964c-0a4008dc5673/Images/Documentation/28891) After clicking **Continue**, a permission popup will appear, based on **Azure AD > Enterprise Applications > Consent and permissions > User consent settings**: ✖ **Do not allow user consent** (everything requires admin approval) vs ✔ **Allow user consent for apps from verified publishers** ![](https://cdn.us.document360.io/e3a59e39-abd3-4423-964c-0a4008dc5673/Images/Documentation/28890) When **Do not allow user consent** is set, users are presented with the **Approval required** dialog (left). When **Allow user consent for apps from verified publishers** is set (or allowed for low-risk permissions), users are presented with the **Permissions requested** dialog (right). ![](https://cdn.us.document360.io/e3a59e39-abd3-4423-964c-0a4008dc5673/Images/Documentation/28889) ![](https://cdn.us.document360.io/e3a59e39-abd3-4423-964c-0a4008dc5673/Images/Documentation/28887) > [!NOTE] > NOTE: > > Users can enter anything in the field: **Enter justification for requesting this app**. The request will be sent to their Microsoft administrator. ### Enabling Admin Consent Requests When user consent is globally disabled, users cannot request access to new enterprise applications. Instead, they see a **Need admin approval** dialog and are unable to submit a request on their own. To enable the request flow for a specific user, an admin must **temporarily** allow admin consent requests and assign a reviewer: 1. Go to **Azure AD > Enterprise applications** 2. Select **Consent and permissions > Admin consent settings** 3. Under **Admin consent requests**, configure: ![enable ursers to request admin consent.png](https://cdn.us.document360.io/e3a59e39-abd3-4423-964c-0a4008dc5673/Images/Documentation/28952) - **Users can request admin consent to apps they are unable to consent to>** set to **Yes** - **Reviewers>** assign the admin user who will grant the consent. ### Granting Permissions by Admin When a tenant is locked down so **users cannot consent**, the admin has to explicitly approve the permissions your app requires. The admin can do this in three ways: #### 1. Approve the app directly from the consent prompt (preferred) When a user tries to install/use the app and hits the Approval required dialog the admin must: 1. Click **Review permissions** (or open the link the user sends) 2. Sign in as a Global Admin or Cloud Application Admin 3. Accept the permissions 4. Optionally check **Consent on behalf of your organization**. 5. If they don’t check that box, only they receive the consent, not the org. **Result**: Everyone in the org can now use the app without being blocked. #### 2. Approve via Azure AD > Enterprise Apps > Admin consent workflow If they want the more bureaucratic path (or already have the request pending): 1. Go to **Azure AD admin portal** 2. Navigate to **Enterprise applications > Admin consent requests** 3. They’ll see your app (“8x8 Work” or similar) in the list 4. Open the request 5. Review requested permissions 6. Click **Approve** 7. Again, they must choose **Consent on behalf of your organization** This also unblocks all users. #### 3. Pre-grant the permissions from the Enterprise App blade If the admin wants to approve without waiting for end-user requests: 1. Go to **Azure AD > Enterprise applications** 2. Find 8x8 app (shows up after first user-triggered attempt or manual add) 3. Open it > **Permissions** 4. Click **Grant admin consent for ** ### Granting permissions by User 1. After the app updates to version 4.0, open the 8x8 for Microsoft Teams app 2. A consent dialog appears with the message: "We need to ask for additional permissions. You should only need to do this once" 3. Click **Continue** 4. A Microsoft permissions dialog appears requesting: - View your basic profile - Maintain access to data you have given it access to 5. Click **Accept** to grant permissions > [!WARNING] > Important: > > Users must grant these permissions to enable automatic token-based authentication. Without accepting permissions, Seamless Login will not function. ### If Permissions Are Declined If a user clicks **Cancel** or declines permissions, they will see an error screen. Users can click the **Retry** button to be re-prompted for the required permissions. ## Troubleshooting ### Authentication Failed Error If you see "Failed to authenticate. Please try again," this typically means: - Your Microsoft Teams username doesn't match your 8x8 username or Federation ID - You don't have an active 8x8 subscription **To resolve:** 1. Click **Retry** to attempt authentication again 2. If the issue persists, verify: - You have an active 8x8 account and subscription - Your username matches the sign-in Microsoft credentials - Your Federation ID is set correctly (if usernames don't match) 3. Contact your IT administrator for assistance with account configuration ### Permissions Not Granted If you declined permissions during the initial setup: 1. Close the 8x8 for Microsoft Teams app 2. Reopen the app 3. Click **Retry** when prompted 4. Accept the permissions in the Microsoft consent dialog ## Deployment Information The Seamless Login feature is included in 8x8 for Microsoft Teams version 4.0. The update is deployed automatically through the Microsoft Teams app store. ## Need Help? If you continue experiencing issues with Seamless Login, contact your IT administrator or [8x8 Support](/support/docs/contact-8x8-technical-support).