eephemail / docs

Quickstart

From zero to a parsed OTP in under 60 seconds.

1. Get an API key

Sign in, open Settings → API keys, and create a key. Treat it like a password.

2. Create an inbox address

curl -X POST https://api.ephemail.io/v1/addresses \
  -H "Authorization: Bearer $EPHEMAIL_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ttl_seconds": 600}'

3. Wait for a message and extract its OTP

const msg = await ephemail.addresses(address.email).waitForMessage({
  matchSubject: /verify/i,
  withOtp: true,
  timeoutMs: 60_000,
});
console.log(msg.otp);

Try it now

Paste your key (stored locally), then call the live API.

POST/addressestry it
Stored in your browser's localStorage only. Never sent to ephemail except as the Bearer header.