Skip to main content
GET
/
mailboxes
List mailboxes
curl --request GET \
  --url https://api.amplemarket.com/mailboxes \
  --header 'Authorization: Bearer <token>'
{
  "mailboxes": [
    {
      "id": "019ae9a7-46e7-7659-ab34-295ad4d6807f",
      "email": "[email protected]",
      "email_provider": "google",
      "daily_email_limit": 50,
      "status": "active",
      "user": {
        "id": "019ae9a7-45ce-7a07-ae9a-0e6a1c49e04b",
        "name": "Example User",
        "email": "[email protected]"
      },
      "created_at": "2025-12-04T13:57:25Z",
      "updated_at": "2025-12-04T13:57:25Z"
    }
  ],
  "_links": {
    "self": {
      "href": "/mailboxes?page[size]=20"
    }
  }
}

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[]