Teams error 403 BotDisabledByAdmin: BotDisabledByAdmin - blocked by tenant admin
Last verified against Microsoft Learn - Status codes from bot conversational APIs
The tenant admin disabled this agentWhat error 403 BotDisabledByAdmin means
A Teams administrator has blocked the app, so the Connector refuses to deliver anything you send. The status table documents the code as BotDisabledByAdmin with the message "The tenant admin disabled this agent" (older doc versions phrase it as "bot") and the description "Admin blocked interactions between user and the agent app. Admin needs to allow the app for the user inside of app policies." The documented retry column is No, and the developer action is explicit: "Stop posting to conversation until interaction with agent is explicitly initiated by a user in the conversation indicating that the agent is no longer blocked."
Nothing is wrong with your credentials, your endpoint, or the conversation reference - this is pure tenant policy. In the Teams admin center an app can be blocked org-wide (Manage apps > Blocked) or removed from the app permission policy that applies to specific users, and either state produces this code. It is the counterpart to ConversationBlockedByUser: there a person blocked you, here an admin did, and only the admin can undo it. Custom apps face an additional gate - if the org's setup policies disallow custom app upload (sideloading), the app may never install in the first place, a scenario walked through in causes 5 and 6 of Teams bot not responding.
Handle it as a suppression signal, not a transient fault. Keeping a retry loop running against a policy block wastes your per-thread rate budget and fills logs with noise while changing nothing.
What it looks like
{
"error": {
"code": "BotDisabledByAdmin",
"message": "The tenant admin disabled this agent"
}
}Why it happens
- A Teams admin set the app's org-wide status to Blocked in the Teams admin center (Manage apps).
- The app permission policy assigned to the affected users does not allow this app.
- The app was blocked after a compliance or security review while installations remained in place.
- For custom apps: the org allows the app but a policy change revoked it for a subset of users, so some conversations work and others 403.
How to fix Teams error 403 BotDisabledByAdmin
- 1Confirm the code in the response body is BotDisabledByAdmin, not ConversationBlockedByUser - the remediation paths differ completely.
- 2Ask a Teams administrator to check Teams admin center > Teams apps > Manage apps: the app's Status must be Allowed.
- 3Have the admin review app permission policies (Teams apps > Permission policies) for the affected users and allow the app there too.
- 4On your side, mark affected conversations as suppressed and stop posting; the documented signal to resume is a user-initiated message from that conversation.
- 5Resume normal sending only after a genuine inbound activity arrives from the conversation.
How to stop it recurring
You cannot prevent an admin's decision, but you can make it less likely and cheap to survive: publish clear admin-facing documentation of what the bot sends and how often, respect notification frequency so the app never looks like spam, and build the suppression path into your sender from day one - a per-conversation kill switch that flips on 403 and off on the next inbound message. For proactive-heavy bots, reconcile suppressed conversations weekly rather than probing them continuously.
Official reference: Microsoft Learn - Status codes from bot conversational APIs. See all Teams error codes or the Teams limits and quotas.
Related codes
- 403 ConversationBlockedByUser: ConversationBlockedByUser - user blocked the botUser blocked the conversation with the agent.
- 403 MessageWritesBlocked: MessageWritesBlocked - proactive send to a blocking userThread is blocked from message writes.
- 403 NotEnoughPermissions: NotEnoughPermissions - operation requires rights the bot lacks*scenario specific
- 403 BotNotInConversationRoster: BotNotInConversationRoster - bot removed from conversationThe agent isn't part of the conversation roster.
Error 403 BotDisabledByAdmin - quick answers
What does Teams error 403 BotDisabledByAdmin mean?
A Teams administrator has blocked the app, so the Connector refuses to deliver anything you send. The status table documents the code as BotDisabledByAdmin with the message "The tenant admin disabled this agent" (older doc versions phrase it as "bot") and the description "Admin blocked interactions between user and the agent app.
How do I fix Teams error 403 BotDisabledByAdmin?
1. Confirm the code in the response body is BotDisabledByAdmin, not ConversationBlockedByUser - the remediation paths differ completely. 2. Ask a Teams administrator to check Teams admin center > Teams apps > Manage apps: the app's Status must be Allowed. 3. Have the admin review app permission policies (Teams apps > Permission policies) for the affected users and allow the app there too. 4. On your side, mark affected conversations as suppressed and stop posting; the…
Stop debugging Teams by hand
Connect the channel through Conferbot: tokens, webhooks and retries are handled, failures show as readable status.