đź”” Heads up: Our login page is getting a fresh look!
We're updating the deskbird login page to improve security and streamline the experience. As part of this change, all available login options (e.g. email/password, Google, Microsoft, SSO) will be visible on the login screen.
What does this mean for you? Simply use the same login method you've always used. If you're unsure which one that is, check with your IT admin or refer to the instructions your company provided when you first signed up.
⚠️ Choosing a different login method than the one configured for your company may result in an error. This doesn't affect your account — just go back and select the correct option.
Having trouble logging in to deskbird? This article covers the most common login issues across the web app, mobile app, and Microsoft Teams, with step-by-step troubleshooting instructions to help you resolve problems quickly.
- MS Teams app: blank or white screen
- Mobile app: SSO login failures
- Duplicate accounts
- Common error messages
- FAQ
1. MS Teams app: blank or white screen
If you open deskbird in Microsoft Teams and see a blank or white screen instead of the app, try the following steps in order:
-
Clear the Teams cache:
- Close Microsoft Teams completely.
- On Windows: open
%appdata%\Microsoft\Teamsand delete the contents of theCache,blob_storage,databases,GPUcache,IndexedDB, andLocal Storagefolders. - On macOS: open
~/Library/Application Support/Microsoft/Teamsand delete the same folders. - Restart Teams.
- Re-authenticate: Remove the deskbird app from Teams (right-click > Uninstall), then re-add it from the Teams app store. This forces a fresh login.
- Check which deskbird app you are using: There may be two versions in the Teams store — deskbird - Make Hybrid work and deskbird. Use deskbird - Make Hybrid work, which is the current version.
- Check corporate policies: Some organisations restrict embedded web apps in Teams. Ask your IT administrator whether any Microsoft Defender for Cloud Apps policies, Conditional Access policies, or web content filtering rules might be blocking the deskbird domain.
If you use multiple Microsoft accounts (e.g., personal and work), the Teams app may not show the account picker when logging in to deskbird. This is a known limitation. Try signing out of all other Microsoft accounts in your browser before launching deskbird in Teams.
2. Mobile app: SSO login failures
If SSO (single sign-on) works on your desktop browser but fails on the deskbird mobile app (iOS or Android), try these steps:
- Update the deskbird app to the latest version from the App Store or Google Play Store.
-
Clear the deskbird app data:
- iOS: delete and reinstall the app.
- Android: go to Settings > Apps > deskbird > Storage > Clear data, then reopen the app.
- Check MDM (Mobile Device Management) restrictions: If your phone is managed by your company, MDM policies may block certain SSO redirects or restrict which apps can open authentication pages. Contact your IT administrator.
3. Duplicate accounts
Duplicate accounts occur when a user signs up manually with an email and password after an account has already been provisioned via SSO, SCIM, or HRIS. This results in two separate accounts for the same person.
The best prevention is to disable email/password registration once SSO or SCIM is configured. This ensures all users log in through the company identity provider and prevents manual signups that create separate accounts. You can manage login methods under Admin > Company > Company profile.
If a duplicate account already exists, contact deskbird support to have the accounts merged. Include the affected user's email address and a brief description of the issue.
4. Common error messages
| Error | Cause | Resolution |
|---|---|---|
| "Login failed" or "Authentication error" | SSO misconfiguration, expired SAML certificate, or user not provisioned. | Check with your IT admin whether SSO is configured correctly. If using SAML, verify the certificate is not expired. |
| "User not found" or "No account" | User has not been provisioned in deskbird (via SCIM, HRIS, CSV, or manual invite). | Ask your deskbird admin to check Admin Portal > Users for the user. Provision them if missing. |
| Blank screen after SSO redirect | Browser or corporate policy blocking the redirect, or cached stale session. |
Clear browser cache and cookies. Try an incognito/private window.
Check
for corporate content filters blocking app.deskbird.com.
|
| "Access denied" or "AADSTS error" | Microsoft Entra ID Conditional Access policy blocking the login. | Contact your Microsoft 365 administrator to verify that deskbird is permitted under your Conditional Access policies. |
5. FAQ
First, ensure the deskbird app is up to date. If your phone is managed by your company, MDM restrictions may be blocking the SSO flow — ask your IT team to verify. You can also try clearing the app data and reinstalling the app. If the issue persists, please contact deskbird support with a brief explanation.
The Teams app may automatically select a cached account without showing the account picker. Try signing out of all Microsoft accounts in your browser first, then relaunch deskbird in Teams. If the issue persists, remove the deskbird app from Teams, clear the Teams cache, and re-add the app. This is a known limitation with embedded apps in Microsoft Teams when multiple accounts are active.
The best prevention is to disable email/password registration once SSO or SCIM is configured. This ensures all users log in through the company identity provider and prevents manual signups that create separate accounts. You can manage login methods under Admin > Company > Company profile.