Developer docs

Proxy Mail QA gives every test account a real inbox. Create a disposable address, sign up with it in the app you’re testing, and get the verification code or link from the email the moment it lands, in one call that waits for it.

Quickstart

The code from a test email, in one call

1. Create an address for the test.
2. Sign up with it in the app you're testing.
3. Wait: the code or link comes back the moment the email lands.

Get an API key How keys work

Node.js

signup.spec.ts

import { ProxyMailQA } from 'proxymail-qa';

const qa = new ProxyMailQA(); // reads PROXYMAIL_QA_API_KEY
const { address } = await qa.createAddress();
const submitted = new Date();
// ...sign up in your app with the address, then:
const { value } = await qa.waitForCode(address, { since: submitted });

Python

test_signup.py

from proxymail_qa import create_address, now, wait_for_code

account = create_address()
submitted = now()
# ...sign up in your app with account["address"], then:
code = wait_for_code(account["address"], since=submitted)

cURL

# Create an address
curl -X POST https://api.proxymail.qa/v1/addresses \
  -H "Authorization: Bearer $PROXYMAIL_QA_API_KEY" -H "Content-Type: application/json" \
  -d '{"label": "Sign-up test"}'

# ...sign up in your app with it, then wait for the code
curl "https://api.proxymail.qa/v1/addresses/k7f2x9ab12cd@mailclub.dev/code" \
  -H "Authorization: Bearer $PROXYMAIL_QA_API_KEY"

AI agent

Ask your agent

Sign up on localhost:3000 with a new Proxy Mail QA address and confirm the email.

After the one-prompt setup, your agent creates the address, fills the form and waits for the code itself.

Start building

PlaywrightSign up and enter the code in a test CypressSign up and open the verification link Pythonpytest with Selenium or Playwright Mobile appsMaestro, XCUITest, Espresso, Flutter A coding agentOne prompt for Claude Code, Cursor and others Running in CIA secret, one address per run, a report

Test email not arriving? Status What’s new Support

Before you start

• You need a Proxy Mail QA account and a project: create one free. Agents that sign in by browser need nothing else; scripts and test suites need an API key.
• Your app has to be able to email any address. Email providers in sandbox or test mode only send to addresses you’ve verified: see Test email not arriving?.
• Proxy Mail QA is for testing apps you build or are allowed to test. See Limits and safety and the Terms.

Testing by hand rather than from code? Proxy Mail QA for Chrome fills sign-up forms with a test account and shows the code or link in the page.