Built for QA & Automation Engineers为 QA 与自动化开发者打造

A Programmable Inbox
Built for Automation
可编程的邮箱,
专为测试而生

Create and manage test inboxes via REST API. OTPs auto-parsed to clean JSON. Webhook push support. Works with Playwright, Cypress, Selenium, and any HTTP client. 通过 REST API 创建和管理测试邮箱。OTP 代码自动解析为 JSON,支持 Webhook 推送。与 Playwright、Cypress、Selenium 无缝集成。

verify-signup.test.js
const inbox = await gridinbox.create();
// Email: test.x92@gridinbox.com

await page.type('#email', inbox.email);
await page.click('#send-code');

// Auto-extracted OTP via API or Webhook
const otp = await inbox.waitForOtp({
  timeout: 30000
});

await page.type('#otp', otp.code);
console.log('✅ Verified!');

Sound familiar?这些场景你是否遇到过?

The common pain points of automated email testing. 自动化邮件测试的典型痛点。

🎭

Disposable inboxes are unreliable临时邮箱服务不可靠

Free disposable email services get blocked by production environments, causing constant test failures and unstable CI/CD pipelines. 免费临时邮箱在生产环境中随时会被平台识别并拒绝,导致测试流程频繁中断,CI/CD 流水线不稳定。

⏱️

Manually waiting for OTPs kills automation手动等待验证码耗尽时间

Manually logging in to find OTPs in the middle of an automated test run defeats the purpose of automation entirely. 每次测试都要人工登录邮箱、找到验证码、再手动输入——自动化流水线里插入手动步骤,根本谈不上"自动化"。

🚫

Rate-limited at scale大规模测试被邮箱服务限速

Running 50 parallel test instances? Traditional email providers rate-limit or ban your accounts before the test suite finishes. 并发运行 50 个测试实例时,传统邮箱服务商直接封号或限速,自动化规模根本跑不起来。

Integrate in 3 Steps三步完成集成

From signup to a working Playwright test in under 15 minutes. 从注册到跑通第一个 Playwright 测试,15 分钟以内。

1

Sign up & get your API Key注册并获取 API Key

Create an account and get your REST API key instantly. Bearer token auth — 3-minute integration setup. 创建账号后立即获取 REST API 密钥。支持 Bearer Token 认证,3 分钟完成集成配置。

2

Dynamically create test inboxes在测试中动态创建邮箱

Create isolated test inboxes with a single API call. Persistent, non-expiring addresses — generated on demand. 通过一行 API 调用创建独立测试邮箱,邮件地址即时生成,持久存储,不会过期。

3

Poll or receive Webhook push轮询邮件或接收 Webhook 推送

Register a Webhook endpoint to receive parsed OTP JSON the instant mail arrives — or use waitForOtp() to poll programmatically. 注册 Webhook 端点,邮件到达时立即推送解析后的 OTP JSON;或使用 waitForOtp() 方法轮询等待。

Everything Your Test Suite Needs测试套件所需的一切

REST API + Webhook dual modeREST API + Webhook 双模式

Poll via GET /messages or register a Webhook URL for instant push on mail arrival. Both return clean JSON. 使用 GET /messages 轮询,或注册 Webhook URL 在邮件到达时即时触发。两种模式均返回清洁的 JSON。

Server-side OTP auto-parsing服务端 OTP 自动解析

HTML emails are parsed server-side. You receive {"code": "382917", "expires_in": 540} — no regex needed. HTML 邮件在服务端自动解析,你拿到的是 {"code": "382917", "expires_in": 540},无需自己写正则。

High concurrency, no rate limits on reads高并发支持,无读取限速

No rate limits on read operations. 100 concurrent test instances — API stays stable and responsive. 读取操作无速率限制。100 个并发测试实例同时运行,API 稳定响应,不封号不限速。

Persistent inboxes that never expire持久邮箱,不过期

Unlike disposable inboxes, GridInbox test mailboxes persist. Reuse them in regression tests and retain full email history. 不同于临时邮箱,GridInbox 测试邮箱持久有效。可复用于回归测试,历史邮件保留可查。

GET /api/v1/messages/latest → 200 OK
{
  "inbox": "test.x92@gridinbox.com",
  "received_at": "2026-04-02T03:12:44Z",
  "from": "verify@amazon.com",
  "subject": "Your verification code",
  "otp": {
    "code": "382917",
    "expires_in": 540
  }
}
Compatible Frameworks
Playwright Cypress Selenium Puppeteer Python requests LangChain n8n Make

What Teams Use GridInbox For典型使用场景

🧪

Automated Signup Flow Testing注册流程自动化测试

Automate signup → OTP → account activation flows in CI/CD. Works with Playwright, Cypress, and Selenium. 在 CI/CD 流水线中自动测试邮件注册、验证码输入、账号激活全流程。支持 Playwright/Cypress/Selenium。

🤖

AI Agent Email VerificationAI Agent 邮件验证

Give LangChain or AutoGPT agents real mailboxes for platform registration and verification — fully unattended. 为 LangChain、AutoGPT 等 AI Agent 提供真实的邮箱用于平台注册和验证,全程无人工干预。

📊

Market Data Email Collection市场数据邮件采集

Subscribe to industry newsletters and price reports from multiple sources. Programmatically extract content for market analysis. 向多个来源订阅行业通讯和价格报告,程序化抓取邮件内容用于市场分析和竞品监控。

🔔

System Health Monitoring系统健康监控

Set up alert inboxes for production systems. Trigger monitoring workflows via Webhook with zero-delay response. 为生产系统设置告警邮箱,通过 Webhook 实时触发监控流程,确保关键邮件通知零延迟响应。

QA & Automation Inbox FAQ 自动化测试邮件常见问题

How do I test email-based OTP authentication flows in Playwright or Selenium?

Create a test inbox via the GridInbox REST API, trigger the OTP email in your test, then poll the GridInbox API for the latest email and extracted OTP. This gives you a real, isolated inbox per test run with no shared mailbox race conditions.

Can I create and delete test inboxes programmatically via API?

Yes. GridInbox's REST API supports full lifecycle management: create a fresh alias for each test case, run the test, then delete or reuse the alias. Ideal for CI/CD pipelines that need isolated, disposable email inboxes on demand.

What is the typical latency from email delivery to OTP availability via the API?

GridInbox processes inbound emails in real time. Once delivered, OTP extraction typically completes within seconds. A polling interval of 2-3 seconds over a 30-second window reliably captures the code for most platforms.

Does GridInbox work with CI/CD pipelines like GitHub Actions or GitLab CI?

Yes. GridInbox's API uses standard HTTPS, so it works in any CI/CD environment — GitHub Actions, GitLab CI, CircleCI, Jenkins, or Docker pipelines. Store your API key as a CI secret and call the API from your test scripts.

What Engineers Say工程师怎么说

★★★★★

"We needed to run 200 concurrent registration tests. Disposable email tools always broke at account 20. With the GridInbox API, all 200 ran without a single block." "我们需要同时跑 200 个并发注册测试。以前用各种临时邮箱工具,总在第 20 个账号时被封。GridInbox API 跑满了 200 个,完全没问题。"

— David K.
Senior Automation Engineer @ DataFlow Inc.高级自动化工程师 @ DataFlow Inc.
★★★★★

"Integrating GridInbox into our Playwright suite took 15 minutes. The waitForOtp() method eliminated all our custom polling logic — email verification in CI is finally reliable." "把 GridInbox 接入 Playwright 只花了 15 分钟。waitForOtp() 这个方法直接省掉了我们自己写的所有轮询逻辑,CI 里的邮件验证终于稳定了。"

— Sarah M.
QA LeadQA 负责人