List mailboxes
The mailboxes connected to your workspace, newest first. Passwords, tokens and server settings are never returned.
Requires the SMTP_READ permission.
apiKeyAuthorizationBearer <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.
limit?integerItems 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.
1 <= value <= 10025cursor?stringThe nextCursor of the previous page. Anything else returns 400.
A page of mailboxes.
application/json- response
data*array<>nextCursor*|Pass as cursor to get the next page. null on the last page.
curl -X GET 'https://app.alienmail.io/api/v1/mailboxes'{ "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}Remove leads DELETE
Removes up to 500 leads from a campaign by email. Their waiting emails are cancelled. The emails the campaign already sent them stay in its statistics, and the people stay in your workspace's leads.
Update a mailbox PATCH
Changes a mailbox's sender name, its daily sending limit, or turns it off and on. Only what you send changes. Server settings, logins and passwords can't be changed through the API: reconnect the mailbox in Alienmail.