Mailboxes API

Updated Mar 29, 2026 · 5 min read

List, get, suspend, resume, export mailboxes.

On this page · 5

GET /v1/mailboxes
GET /v1/mailboxes/:id
POST /v1/mailboxes/:id/suspend
POST /v1/mailboxes/:id/resume
GET /v1/mailboxes.csv

The mailboxes API exposes the full lifecycle of every mailbox in your workspace.

GET /v1/mailboxes

List all mailboxes. Supports filter parameters: status (live/warming/suspended), domain, tag, created_after, created_before. Returns paginated cursor-based results.

curl https://api.inboxlee.com/v1/mailboxes?status=live \
  -H "Authorization: Bearer $INBOXLEE_API_KEY"

GET /v1/mailboxes/:id

Returns full mailbox detail including SMTP/IMAP credentials (only if your key has the credentials:read scope), warmup-day, daily volume, current health score.

POST /v1/mailboxes/:id/suspend

Suspends a mailbox. Suspended mailboxes do not send and do not count toward billing for the days they are suspended.

POST /v1/mailboxes/:id/resume

Resumes a suspended mailbox. Sending limits return to the appropriate warmup-day cap.

GET /v1/mailboxes.csv

Returns the same CSV that the dashboard exports - useful for automated syncs to sending tools without native API support.

← All docs Try Inboxlee free →