---
title: mailbox.disconnected
description: The mailbox was removed.
sidebar:
  label: mailbox.disconnected
  icon: user-x
---

The mailbox was removed — by you, or by the customer revoking access at the provider.

## Payload

| Prop | Type | Default | Description |
| - | - | - | - |
| `mailbox_id` | `string` | - | mbx_… |
| `address` | `string` | - | The mailbox address. |
| `provider` | `"google" \| "microsoft"` | - | Which provider. |
| `reason` | `string \| null` | - | Why, when known. |

## Handling it

Unlike [`mailbox.needs_reauth`](/webhooks/events/mailbox-needs-reauth), this is terminal — there is no authorization left to refresh. Clear the mailbox from your own UI rather than showing it as broken, and send the customer back through the connect flow if they want it again.
