Folders API

Query and manage mailbox folders (IMAP mailboxes) via the REST API.

List folders

GET /api/folders
Authorization: Bearer <token>

// Response
{
  "ok": true,
  "folders": [
    { "id": "inbox", "name": "INBOX", "unreadCount": 3, "totalCount": 142 },
    { "id": "sent", "name": "Sent", "unreadCount": 0, "totalCount": 89 },
    { "id": "trash", "name": "Trash", "unreadCount": 0, "totalCount": 12 }
  ]
}

List emails in a folder

GET /api/inbox?folder=INBOX&page=1&limit=20
Authorization: Bearer <token>

Next steps

• Send Mail →
• Webhooks →