Skip to Content
Alienmail Docs
Mailboxes

List mailboxes

GET
/mailboxes

The mailboxes connected to your workspace, newest first. Passwords, tokens and server settings are never returned.

Requires the SMTP_READ permission.

Authorization

apiKey
headerAuthorizationBearer <token>

An API key of your workspace, from Workspace settings, Integrations. Each key has a role, and the role decides which endpoints it may call.

Query Parameters

limit?integer

Items per page, 1 to 100. Default 25. A number outside that range is rounded to the nearest limit (0 is 1, 500 is 100) and a fraction rounded down; anything that is not a number is the default.

Range1 <= value <= 100
Default25
cursor?string

The nextCursor of the previous page. Anything else returns 400.

Response Body

A page of mailboxes.

application/json
  1. response
data*array<>
nextCursor*|

Pass as cursor to get the next page. null on the last page.

Example Request
curl -X GET 'https://app.alienmail.io/api/v1/mailboxes'
Example Response
{  "data": [    {      "id": 7,      "email": "ada@analyticalengines.com",      "name": "Ada from Analytical Engines",      "provider": "google",      "active": true,      "connected": true,      "rateLimited": false,      "dailyLimit": 50,      "sentToday": 12,      "createdAt": "2026-11-13T09:30:00.000Z",      "updatedAt": "2026-11-13T09:30:00.000Z"    }  ],  "nextCursor": null}