API Docs / Operations / Email - Mailbox / List Folders

List Folders

GET /tenants/{tenant}/mailbox/folders

Returns the full folder/label set across the tenant's read-enabled mailbox configurations. When configCode query param is omitted, returns folders for every accessible config (owned or shared). When configCode is provided (repeatable), narrows to those configs. Set systemFoldersOnly=true to return only provider-system folders (Inbox/Sent/Drafts/Archive/Junk/Trash/Outbox/GmailPromotionalCategory) — combined-mailbox views use this. Each folder includes per-folder total and unread counts.

Parameters

NameTypeDescription
tenant* path string

The Tenant.Code

The Tenant.Code

configCode query array
systemFoldersOnly query boolean

Responses

200 OK
400 Bad Request
401 Unauthorized – Invalid or missing API key

Try it