🧾 What This Article Covers
In this guide, we’ll walk through:
Integration requirements
How the integration works
Step-by-step setup instructions
Required permissions and what they do
✅ Requirements
To integrate Gable with Microsoft Teams, the following permissions and roles are needed:
A user with both Microsoft Admin and Gable Administrator roles must authorize the connection.
If you’re a Microsoft Admin but not a Gable Administrator, reach out to your Gable Admin to grant temporary admin access. They can revert your role after setup.
A Microsoft Admin must enable third-party apps for your organization to allow installation of the Gable app.
A Microsoft Admin must also authorize Microsoft Graph API permissions required by the Gable app.
⚙️ How It Works
Once connected, Gable’s Microsoft Teams app:
Automatically installs into all Teams.
Can be manually removed from specific Teams if desired.
Will reinstall only if you later configure notifications to that Team channel in Gable.
🔐 Required Permissions
Permission | Type | Description | Purpose |
ChannelSettings.Read.All | Application | Read the names, descriptions, and settings of all channels | Allows Gable Admins to configure channel notifications from the Gable web app |
Team.ReadBasic.All | Application | Get a list of all teams | Enables selection of Teams for notifications |
TeamsAppInstallation.ReadWriteSelfForTeam.All | Application | Allow the Teams app to manage itself for all teams | Used to automatically install Gable’s bot in Teams |
User.Read | Delegated | Sign in and read user profile | Authenticates users within Teams |
🚀 Integration Walkthrough
1. Allow the Gable App for Your Organization
Your Microsoft Admin must first approve the Gable app for your company.
2. Navigate to the Integrations Page
Go to:
Profile Dropdown ➝ Company Admin ➝ Settings ➝ Integrations
3. Connect Microsoft Teams
Click Connect on the Microsoft Teams integration card.
You’ll be redirected to the Microsoft Admin consent page.
4. Authorize the Gable App
Grant the requested permissions on the Microsoft page.
Once redirected back to Gable, wait a few moments for the setup to complete.
5. Configure Channel Notifications
In Gable, select your preferred default channel to receive booking notifications.
You can also assign notifications by locations, if needed.
6. Install the Gable App in Microsoft Teams
Open Microsoft Teams and search for “Gable.”
Click Install, then follow the instructions in the Home tab to link your account.
🎉 Your Microsoft Teams integration is now complete!
🎥 Loom Walkthrough
❓ FAQs
🔍 What Teams data (channels, members, messages, etc.) does the Gable app read or write?
Gable only accesses the data necessary to enable the integration features described in the setup documentation. Please refer to the permissions table in this article above for full details.
🌐 Does Gable store or process any Teams or user data outside our Microsoft 365 tenant?
Yes. Gable processes limited data using the same secure backend services within the same geo-region and under the same security and compliance measures as the rest of our platform.
All data is protected through encryption, logical segregation, and strict retention policies.
For more details, please review our SOC 2 report or visit our Security Page.
🔔 How are updates managed and communicated—especially if new permissions are added?
Gable cannot modify permissions after installation.
All access is granted through Microsoft’s standard OAuth consent flow, which always requires an explicit user or admin approval.
🔑 What service principal or credentials does the app use, and how are they protected or rotated?
The integration uses Microsoft’s standard OAuth 2.0 flow.
A user with the required admin permissions must complete the authorization process.
No persistent credentials are stored by Gable — access tokens are managed and secured through Microsoft’s identity infrastructure.
🚫 Why am I seeing the error “Blocked by publisher”?
If you’re seeing the message “Blocked by publisher”, it means that the Gable app must be installed by a Microsoft Teams admin in your organization.
Ask a Teams admin in your tenant to install the Gable app through the Teams Admin Center. Once the app has been approved and installed by an admin, you’ll be able to use it normally.
💬 Need Help?
If you have any questions or run into issues setting up your integration, please reach out to our team at support@gable.to.