---
title: "Mailbox List"
method: GET
path: "/mailboxes"
tags: ["mailboxes"]
---

# Mailbox List

`GET /mailboxes`

## Headers

- `x-notte-request-origin` string, nullable
- `x-notte-sdk-version` string, nullable

## Response `200`

Successful Response

- MailboxListResponse
  - `items` MailboxConnection[], required
    - `id` string, required
    - `provider` 'gmail' | 'microsoft_outlook'
    - `email_address` string, required
    - `healthy` boolean
    - `authorized_scopes` string[]
    - `allow_all_senders` boolean
    - `allowed_sender_domains` string[]
    - `created_at` string, date-time, nullable
    - `updated_at` string, date-time, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/notte/apis/notte-api.md) · [All operations](https://skmtc.net/notte/apis/notte-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/notte/notte-api/revisions/07af155aa3ff/schema)
