TestLab automation API

Create isolated test inboxes and make deterministic assertions from Playwright, Cypress, CI jobs or any HTTP client.

Authenticate

Create a scoped key in TestLab and send it only from protected server-side or CI environments.

Authorization: Bearer mv_live_...

Create an inbox

POST /api/v1/inboxes
Content-Type: application/json

{"alias":"signup-123"}

Wait for email

GET /api/v1/messages/wait?inbox=signup-123&timeout=20
Authorization: Bearer $MAILVATOR_API_KEY

The response includes sender, subject, text preview, received time, extracted links and a likely OTP.

Fetch and delete

GET /api/v1/messages/{messageId}
DELETE /api/v1/inboxes/{alias}

Deletion removes the private inbox marker and its messages. Other data expires under the active plan's retention period.

OpenAPI specification

Use the OpenAPI 3.1 specification for generation, validation and Postman import.