mailbox.connected
A customer finished authorizing a Gmail or Outlook mailbox.
A customer finished authorizing a Gmail or Outlook mailbox.
Payload
mailbox_idstring
mbx_…
stringaddressstring
The mailbox address.
stringprovider"google" | "microsoft"
Which provider.
"google" | "microsoft"app_idstring | null
Your OAuth app, or null when the shared AI Inbx app was used.
string | nullref?string
The ref you put on the connect link or passed to mailboxes.connect — how you match this to your user.
stringreconnectedboolean
true when this replaced an existing authorization rather than adding a new mailbox.
booleanHandling it
This — not the browser landing back on return_to — is the signal that the mailbox is live. The redirect happens whether or not the grant completed, and a customer who closes the tab never triggers it at all.
Match on ref — whatever you put on the connect link or passed to mailboxes.connect — to attach the mailbox to the right user in your database.
Mailboxes
The connect flow end to end, including your own OAuth app.