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. Base URL: https://api.openmail.sh

API Overview

Base URL, error format, and common error codes

Authentication

Bearer token and API key setup

Inboxes

Create, list, get, and delete inboxes

Messages

Send email, list messages, and manage threads

​
Quick reference

​
Authentication
string
Authorization: Bearer om_live_...
​
Idempotency
string
Send endpoint requires Idempotency-Key header (UUID)
​
Webhooks
string
See Webhooks guide for payload and signature verification
​
Rate limits
string
100 inbox creations/day; 10 sends/min and 200/day per inbox