airbox.fyi

API & SDK

Manage inboxes, connections, and activity programmatically

Base URL

http://localhost:8000

Interactive OpenAPI docs (Swagger) are served at http://localhost:8000/docs.

Authentication

The dashboard uses a signed HTTP-only session cookie. The SDK and scripts use X-API-Key — mint a key in Dashboard → Settings (shown once).

See Authentication.

Quick example

curl -s http://localhost:8000/inboxes \
  -H "X-API-Key: YOUR_KEY" | jq

Authentication

Session cookie, API key rotation, login flows

Inboxes

Create, route, rotate, test, and delete addresses

Connections

LLM providers, MCP servers, Notion OAuth

Messages

Activity log — status, results, usage

Webhooks

Inbound SendGrid parse and self-hosting