đĄ To set up the integration, you need CoLab administrator access and a Microsoft account with the Teams Administrator role. The Microsoft account used to connect must also have either the Cloud Application Administrator or Application Administrator role in Microsoft Entra to approve the permissions requested during connection.
Ensure your team never misses another notification by installing the CoLab integration for Teams, which will seamlessly push vital notifications into your Teams environment.
In this article, we'll go over the steps to install the CoLab app for Teams, starting with downloading the app from CoLab, installing it on Teams, and ensuring the app is connected.
Before you begin
Use a dedicated service account for this integration
The dedicated Microsoft service account must have:
A valid Microsoft Teams license.
The Teams Administrator role.
Either the Cloud Application Administrator or Application Administrator role in Microsoft Entra for the connection and consent step.
â ď¸ The service account must retain the Teams Administrator role to maintain the integration. Avoid temporary assignments of this role that expire automatically.
Required scopes and permissions
The connection from CoLab requests the following 11 delegated permissions, including identity scopes.
OAuth / Identity Scopes:
openidemailoffline_access
Microsoft Graph API Permissions:
AppCatalog.SubmitChat.ReadChat.ReadWriteChatMessage.SendTeamsAppInstallation.ReadForUserTeamsAppInstallation.ReadWriteForUserTeamsAppInstallation.ReadWriteSelfForUserUser.ReadBasic.All
Note: These must be configured as Delegated Permissions (not Application Permissions).
âšď¸ Note: App installation requests additional permissions, including TeamsAppInstallation.ReadWriteForUser.All as an Application permission. This is separate from the delegated permission TeamsAppInstallation.ReadWriteForUser requested during connection. Approval of the Application permission does not cover the delegated permission.
Downloading the integration from CoLab
To install a custom app into Teams, you need a .zip file for the app.
In CoLab, go to Company & Admin â Integrations and select Microsoft Teams.
This will bring you to a Microsoft Teams Connect Portal page. Download the app's .zip file from the link in the Connect Portal description.
Install the integration
In the Teams Administration Dashboard (https://admin.teams.microsoft.com/dashboard), select Teams apps > Manage apps
In the top right corner of the screen, select the Actions dropdown > Upload new app. Select the previously downloaded .zip file.
Once the CoLab app has been added, search for it in the table of All apps to make sure it was properly added.
Blocked apps
It is possible, based on company policy, that the App status might be Blocked. The app must be Unblocked to be used.
If Blocked, follow the steps in the Microsoft Teams documentation to unblock it.
To learn more, the Managing apps Microsoft Teams documentation can be found here.
Ensure your integration is fully connected
Select the CoLab app to view its settings. On the About page, copy the App ID - this will be used to confirm your connection in CoLab. Note that this is not the External App ID - we specifically need the App ID itself.
â ď¸ Approving the app during installation may not cover every permission requested when connecting from CoLab. Use the dedicated service account with Teams Administrator and either Cloud Application Administrator or Application Administrator assigned in Microsoft Entra. Review and accept the requested permissions during connection.
In CoLab, return to Company & Admin â Integrations and select Microsoft Teams.
Click Connect and sign in with the dedicated service account. Review and accept the requested permissions. The window closes automatically once the connection succeeds.
Once connected, the Connect portal will show two settings under the Configuration tab.
App ID (required): Paste the App ID copied from Teams Admin Center.
Allow automatic installation (optional):
If Yes is selected, when a user receives their first CoLab notification through Teams, the CoLab app will install itself for individuals that have yet to install it manually. Only those who receive CoLab notifications will have this happen.
If No is selected, only those users who opt in and install the integration through Teams will receive notifications through the Teams integration.
We recommend allowing automatic installation where possible for the smoothest user experience.
After the installation is complete, you can receive CoLab notifications in Teams.
đ§ Users receive notifications through Teams based on their notification preferences for in-app notifications.










