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

Custom domains

Send and receive from your own domain

​
Quick reference

​
string
Authorization: Bearer om_...
​
string
Send endpoint accepts an optional Idempotency-Key header (UUID) that makes retries safe
​
string
See Setup for payload and signature verification
​
string
100 inbox creations/day; 10 sends/min and 200/day per inbox