Skip to content
AI Inbx
Esc
navigateopen⌘Jpreview
On this page

mailbox.needs_reauth

The stored authorization stopped working.

The stored authorization stopped working: revoked access, a password change, an admin policy.

Payload

PropType
mailbox_idstring

mbx_…

Typestring
addressstring

The mailbox address.

Typestring
provider"google" | "microsoft"

Which provider.

Type"google" | "microsoft"
reasonstring | null

What the provider said, when it said anything.

Typestring | null

Handling it

Prompt the customer to reconnect here. Sync has already stopped, and sends will fail with mailbox_inactive until it’s fixed.

This is the one mailbox event worth paging a human about — every hour it goes unhandled is an hour of that customer’s mail silently not moving.

Last updated on September 9, 2026

Was this page helpful?