Disconnecting Microsoft Teams is 1 click, and any account admin can do it. Changing who owns the connection uses the same button, because there is no take-over option. This article covers both, plus what to do when the card says Reconnect required.
ℹ️ Important: disconnecting stops Teams for your whole company, not just for you. Calls held while Teams is disconnected are never picked up, even after you reconnect.
1. Before you disconnect
| Question | Answer |
|---|---|
| Who can disconnect? | Any Spekit account admin |
| Does it affect everyone? | Yes. It stops Teams for the whole company |
| Do calls already in Spekit disappear? | No. Calls that already arrived stay |
| Can I get back the calls held while it was off? | No. They are never picked up later |
| Do I have to redo the Microsoft setup afterwards? | No. The PowerShell policy and the Teams admin center settings are company settings and stay done |
ℹ️ Note: how long calls are kept after a disconnect is still being decided. If you need a firm answer for a security or legal review, submit a request.
2. Disconnect Microsoft Teams
- In the Spekit Hub (Web App), go to Settings, then Connect
- In the Integrations section, find the Microsoft Teams card.
- Select Disconnect Microsoft Teams.
That is the whole thing. No Microsoft admin is needed to disconnect.
💡 Pro Tip: disconnecting in Spekit does not touch Microsoft. Spekit's app and the access policy stay in your Microsoft tenant until someone removes them. See section 4 if you want them gone too.
3. Change who connected Teams
The Microsoft Teams card shows Connected by and a name. There is no button to hand that over to someone else. To change it, you disconnect and connect again.
-
Select Disconnect Microsoft Teams.
- Select Generate link for your Microsoft admin.
-
Select Copy and send the link to the new Microsoft admin. They open it, enter the Tenant ID, and approve. See [Admin Guide] Setting up the Microsoft Teams Integration for the full instructions.
- Select Refresh status. The card should say Connected by the new name.
ℹ️ What Refresh status does: it re-checks the connection with Microsoft and updates what the card says. It does not go looking for missing calls. If the card says Connected but calls are not arriving, that is a different problem. See Troubleshooting the Microsoft Teams Integration.
ℹ️ Important: do both steps in 1 sitting. Any call held between the disconnect and the new connection is lost. The connect link also expires after 30 minutes.
You do not need to redo the PowerShell policy or the Teams admin center settings. Those belong to the company, not to the person who connected.
When to do this
| Situation | What to do |
|---|---|
| The person who connected Teams is leaving | Reconnect with a current Microsoft admin before their last day |
| Their Microsoft account was already disabled | Reconnect now. The connection may break on its own |
| You are only changing Spekit admins | Nothing to do. The Spekit admin who generated the link is not the owner. The Microsoft admin who approved is |
4. Remove Spekit from Microsoft as well
Disconnecting in Spekit is enough to stop the calls. If your security team wants Spekit removed from your Microsoft tenant too, your Microsoft admin does this:
- In Microsoft Entra, go to Enterprise apps.
- Find the Spekit app and delete it.
- Remove the access policy that lists Spekit's app ID,
0df52125-4f1b-4177-b16a-125310d5451e.
ℹ️ Note: if your tenant has a shared Global access policy with other products in it, remove only Spekit's app ID from the list. Do not delete the whole policy.
5. When the card says Reconnect required
This means Spekit could reach Microsoft Teams before, but cannot now. The usual cause is that the approval was removed in Microsoft.
-
Select Disconnect Microsoft Teams.
-
Select Generate link for your Microsoft admin.
- Have a Global Administrator or Privileged Role Administrator open it and approve. See [Admin Guide] Setting up the Microsoft Teams Integration for the full instructions.
Calls held while the connection was broken are not picked up later. The sooner you reconnect, the fewer you lose.
6. Best practices
| Practice | Why it helps |
|---|---|
| Reconnect in the same sitting | Calls held in the gap are lost for good |
| Reconnect before an admin leaves, not after | Once their Microsoft account is gone, the connection can break with no warning |
| Pick a Microsoft admin who is not leaving soon | It saves you doing this again |
| Check the card after any Microsoft permissions cleanup | Removing consent in Entra flips the card to Reconnect required |
| Tell your reps before you disconnect | Their Meetings list stops filling, and they will open a ticket |
💡 Pro Tip: put a calendar reminder on the Microsoft Teams card status if your company does regular Entra permission reviews. A cleanup that looks harmless in Microsoft can quietly stop every Teams call reaching Spekit.
7. Common questions
Can a rep disconnect Teams by accident? No. Only account admins see the buttons on the card.
Do I lose the calls that are already in Spekit? No. They stay.
Do I have to redo the PowerShell steps when I reconnect? No. Those are company settings in Microsoft and they stay in place.
Can 2 people be connected at the same time? No. 1 connection covers the whole company, and 1 Microsoft admin is recorded as having approved it.
Does disconnecting remove Spekit's access in Microsoft? No. See section 4.