# List connected mailboxes

Source: https://docs.maylee.app/api-reference/mailboxes/list-mailboxes

`GET https://api.maylee.app/api/v1/mailboxes`

Scope: `read`.

Call this to resolve the `mailboxId` every send and most filters need.

## Example request

```bash
curl -X GET "https://api.maylee.app/api/v1/mailboxes" \
  -H "Authorization: Bearer $MAYLEE_KEY"
```

## Responses

### 200

Connected mailboxes.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `items` | array of Mailbox | no |  |
| `items[].backwardSyncComplete` | boolean | no |  |
| `items[].createdAt` | string (date-time) | no |  |
| `items[].email` | string (email) | no |  |
| `items[].id` | string | no |  |
| `items[].isActive` | boolean | no |  |
| `items[].lastSyncAt` | string or null | no |  |
| `items[].name` | string or null | no |  |
| `items[].picture` | string or null | no |  |
| `items[].provider` | string | no |  |
| `items[].syncError` | string or null | no |  |

```json
{
  "items": [
    {
      "backwardSyncComplete": true,
      "createdAt": "2026-06-02T09:14:31.000Z",
      "email": "contact@your-company.com",
      "id": "cmbx1a2b3c4d5e6f7g8h9i0j",
      "isActive": true,
      "lastSyncAt": "2026-08-25T14:02:11.000Z",
      "name": "Contact",
      "picture": null,
      "provider": "GOOGLE",
      "syncError": null
    }
  ]
}
```

### 401

Missing, malformed, revoked or expired API key.

### 403

Key lacks the required scope, or outbound sending is not enabled on it.

### 429

Per-minute rate limit (`RATE_LIMIT_EXCEEDED`) or monthly quota (`QUOTA_EXCEEDED`) exhausted.

Errors use the format `{ "code", "error", "details" }`: see [Errors](/errors.md).