List mailboxes
The ops list and the profile editor’s picker share this endpoint.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Query Parameters
320Whether the mailbox's grant currently authenticates.
connected, disconnected Which email provider a mailbox connects through.
Phase 1 ships Google Workspace only; every provider is implemented behind
providers.EmailProviderBase so Office 365 and IMAP/SMTP can be added
later without touching callers.
GOOGLE_WORKSPACE holds a per-mailbox OAuth grant (consent screen,
refresh token). GOOGLE_WORKSPACE_DWD holds no grant at all: tokens are
minted on demand via domain-wide delegation as the platform service
account, so its rows carry an empty refresh_token forever — the path
imported fleets (e.g. InboxKit) connect through.
google_workspace, google_workspace_dwd ^(today|yesterday)$^(email_address|display_name|provider|connection_status|sender_profile_id)$^(asc|desc)$1 <= x <= 200x >= 0