Skip to main content
Welcome to the openmail API. Our API is organized around REST. It has predictable resource-oriented URLs, accepts JSON-encoded request bodies, and returns JSON-encoded responses.

Inboxes

Programmatically create and manage dedicated email addresses for your AI agents.

Messages

Send emails, receive replies via webhooks, and manage message threads in real-time.

Attachments

Access files from inbound emails via signed download URLs.

Webhooks

Set up real-time event notifications when inbound email arrives.

​
Authentication

The openmail API uses API keys to authenticate requests. You can manage your API keys in the Dashboard. Your API keys carry many privileges, so be sure to keep them secure.
Important: All API requests must be made over HTTPS. Calls made over plain HTTP will fail. API requests without authentication will also fail.

​
Header example

# Authentication is performed via Bearer token
curl https://api.openmail.sh/v1/inboxes \
  -H "Authorization: Bearer om_live_YOUR_SECRET_KEY"

Quickstart

Go from zero to sending and receiving email in 5 minutes.