---
title: Mailboxes API
description: "Use the AI Inbx mailboxes API. Browse endpoints, request parameters, response schemas, and code examples for your integration."
sidebar:
  label: Overview
---

{/* Generated by scripts/openapi.ts from the shared API contract. */}

Connect and manage provider mailboxes.

## Endpoints

| Method | Operation | Path |
| --- | --- | --- |
| `GET` | [List mailboxes](/api/endpoints/mailboxes/list-mailboxes) | `/mailboxes` |
| `POST` | [Create a mailbox connection URL](/api/endpoints/mailboxes/connect-mailbox) | `/mailboxes/connect` |
| `GET` | [Retrieve a mailbox](/api/endpoints/mailboxes/retrieve-mailbox) | `/mailboxes/{mailbox_id}` |
| `DELETE` | [Disconnect a mailbox](/api/endpoints/mailboxes/disconnect-mailbox) | `/mailboxes/{mailbox_id}` |
| `POST` | [Queue a mailbox sync](/api/endpoints/mailboxes/sync-mailbox) | `/mailboxes/{mailbox_id}/sync` |

## Request essentials [#request-essentials]

Use `https://api.aiinbx.com/api/v2` as the base URL and send your API key in `Authorization: Bearer <key>`. Keep credentials on your server.

See [Authentication](/authentication) for scopes, [Conventions](/reference/conventions) for pagination and idempotency, and [Errors](/reference/errors) for recovery guidance. Each endpoint page includes its parameters, response schemas, and copyable curl, JavaScript, and Python examples.