Inboxes

Create and manage Airbox email addresses and routing

Endpoints

Method	Path	Description
GET	/inboxes	List your inboxes
POST	/inboxes	Create inbox
PATCH	/inboxes/{id}	Update routing, allowlist, scope, reply toggle
POST	/inboxes/{id}/rotate	Rotate local-part → new address
POST	/inboxes/{id}/test	Send a test message through the pipeline
GET	/inboxes/{id}/vcard	Download vCard for the address
DELETE	/inboxes/{id}	Delete inbox

Create

POST https://api-test.airbox.fyi/inboxes
Content-Type: application/json
X-API-Key: YOUR_KEY

{
  "label": "Work",
  "default_connection_id": "uuid-of-llm-connection",
  "mcp_connection_ids": ["uuid-of-mcp"],
  "reply_enabled": true,
  "allowlist_senders": ["you@company.com"]
}

Routing fields

default_connection_id — AI or LLM provider for this address
mcp_connection_ids — attached tool servers (Notion, MCP, etc.)
reply_enabled — email results back (default true)
scope — optional { targets: [...] } capability restrictions