Relay REST API

Real email.
One small API.

Create addresses, receive messages, and read verification codes. A simple receiving API for the things you build.

JSON over HTTPSScoped API keysAccount-owned inboxes

Create an inbox

POST/inboxesrequest.sh

1curl -X POST "https://www.relaymcp.net/api/v1/inboxes" \2  -H "Authorization: Bearer $RELAY_API_KEY" \3  -H "Content-Type: application/json" \4  -d '{"name":"my-inbox","domain":"your-mail-domain.com"}'

An address for every flow

Separate test runs and projects with their own inboxes. Use a Free domain or connect one you own.

More than a subject line

Read message bodies, sanitized HTML, attachment metadata, and detected verification codes.

Access stays in your hands

Keys are scoped, hashed, and revocable. Each key accesses only its account's inboxes.

A predictable surface

The essentials, in a few requests.

Full reference

POST/inboxesCreate a fresh inbox GET/domainsChoose an available domain GET/inboxes/{id}/messagesList incoming mail GET/inboxes/{id}/messages/{messageId}Read a message and its attachments GET/inboxes/{id}/messages/{messageId}/otpRetrieve a verification code

A good fit for your test suite.

Use Relay with Playwright, Cypress, CI pipelines, or your own application. Start with a fresh inbox and poll for the message you expect.

Read the Playwright guide

Real email.One small API.