Skip to main content
GET
/
mailboxes
List mailboxes
curl --request GET \
  --url https://api.amplemarket.com/mailboxes \
  --header 'Authorization: Bearer <token>'
{
  "mailboxes": [
    {
      "id": "019dfcc5-f1ae-7dd6-bd56-79ad9e634f03",
      "email": "mailbox@example.com",
      "email_provider": "google",
      "daily_email_limit": 50,
      "status": "active",
      "user": {
        "id": "019dfcc5-f0bf-7d95-9dbd-9e5d74c62f18",
        "name": "Example User",
        "email": "foo-21@email.com"
      },
      "created_at": "2026-05-06T10:12:04Z",
      "updated_at": "2026-05-06T10:12:04Z"
    }
  ],
  "_links": {
    "self": {
      "href": "/mailboxes?page[size]=20"
    }
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.amplemarket.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

page[size]
string

Page size (max 20)

page[after]
string

Page after

page[before]
string

Page before

status
enum<string>

Filter by mailbox status

Available options:
active,
inactive,
needs_reconnection
email_provider
enum<string>

Filter by email provider

Available options:
google,
outlook,
other,
other_mixed
user_email
string

Filter by user email

Response

200 - application/json

Successful

mailboxes
object[]