List mailboxes
Mailboxes
List mailboxes
Plans: Free · Developer · Enterprise
Lists mailboxes visible to the caller. Pass workspaceId to scope a session user; API keys are always scoped to their bound workspace. Each item includes inbox_unread_by_category.
API credits: 1 (read).
GET
List mailboxes
Authorizations
API key (sk-proj-…) from Settings → API Keys. Required for sold API calls outside the Mermail console.
Query Parameters
Filter by workspace id (session users). API keys ignore cross-workspace values and stay on the key’s workspace.
Response
Mailbox list
Hosted alias primary key (also accepted as mailboxId)
Stable public route id; preferred mailboxId for agents and clients
Present on list endpoints only