Building, integrating, or customizing apps and workflows within Microsoft Teams using developer tools and APIs
Hi Rich,
Thank you for providing those specific details.
As far as I know, the issue you are encountering is primarily due to the lack of functional capabilities in your manifest.
While your manifest is technically valid against the schema, the Teams platform requires at least one "entry point" (capability) to allow a user to install the app. Without a successful installation, the app is not assigned an installationId, which is why your Graph API /installedApps call returns empty.
When you run locally with the Toolkit, it uses Direct Sideloading, which may bypass several Org-wide policy checks and "empty manifest" validation steps. The Org Store (Cloud deployment) is significantly stricter about structural requirements.
Here is the recommended path to troubleshoot this:
1. Add a Minimal Capability
Teams requires a UI surface (like a tab or bot) to trigger the installation flow. You can add a minimal "About" page as a Static Tab:
- This provides an "Open" button in the app store.
- Clicking "Open" triggers the installation, which then registers the
installationIdin the Graph. - Example snippet for your manifest:
"staticTabs": [ { "entityId": "about", "name": "About", "contentUrl": "https://yourdomain.com/about", "scopes": ["personal"] } ]
2. Manifest Version Check
You are using manifestVersion: "1.25". This version was released very recently (Jan 2026) and is designed for specific AI/Agentic features. Try downgrading to v1.16 or v1.17 (the current standard for broad compatibility). Some production Teams clients may still have validation issues with v1.25 features when deployed through the Org Store.
3. Verify Admin Center Settings
The "Check with your admin" error usually means a permission policy is blocking the app:
- Manage Apps: Search for your ID in the Teams Admin Center and ensure the status is "Allowed".
- Permission Policies: Ensure "Custom Apps" are allowed in the Global policy or the policy assigned to your user account.
I hope this helps.
If the answer is helpful, please click "Accept Answer" and kindly upvote it. If you have extra questions about this answer, please click "Comment".
Note: Please follow the steps in our documentation to enable e-mail notifications if you want to receive the related email notification for this thread.