Inbox API
Programmatic inboxes
for AI agents.
Create inboxes, send and receive emails, manage threads and drafts, and more — all over a clean REST API or TypeScript / Python SDK.
Live API walkthrough
Capabilities
The Inbox API gives AI agents, automations, and backend services programmatic access to real email addresses. Each inbox is a fully functional mailbox — capable of sending and receiving messages, organising threads, triggering webhooks, and handling attachments — all over a clean REST interface.
Unlike transactional email services that only send, the Inbox API is bidirectional. Your agent can create a dedicated address, send an outbound email, and immediately receive and parse the reply — all without any UI interaction.
Architecture
Inbound mail arrives at your inbox address and is forwarded to your registered webhook endpoint in real time. Outbound mail is dispatched with DKIM signing and SPF alignment.
Inbound flow
──────────────────────────────────────────────────────
Internet → MX record → Mail server → Inbox API
│
webhook delivery
│
Your server
Outbound flow
──────────────────────────────────────────────────────
Your code → POST /inboxes/{id}/messages → Mail server → InternetBase URL: https://api.imperius-ai.com/api/v0 — all endpoints are relative to this base.