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 无缝集成。
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!');
The common pain points of automated email testing. 自动化邮件测试的典型痛点。
Free disposable email services get blocked by production environments, causing constant test failures and unstable CI/CD pipelines. 免费临时邮箱在生产环境中随时会被平台识别并拒绝,导致测试流程频繁中断,CI/CD 流水线不稳定。
Manually logging in to find OTPs in the middle of an automated test run defeats the purpose of automation entirely. 每次测试都要人工登录邮箱、找到验证码、再手动输入——自动化流水线里插入手动步骤,根本谈不上"自动化"。
Running 50 parallel test instances? Traditional email providers rate-limit or ban your accounts before the test suite finishes. 并发运行 50 个测试实例时,传统邮箱服务商直接封号或限速,自动化规模根本跑不起来。
From signup to a working Playwright test in under 15 minutes. 从注册到跑通第一个 Playwright 测试,15 分钟以内。
Create an account and get your REST API key instantly. Bearer token auth — 3-minute integration setup. 创建账号后立即获取 REST API 密钥。支持 Bearer Token 认证,3 分钟完成集成配置。
Create isolated test inboxes with a single API call. Persistent, non-expiring addresses — generated on demand. 通过一行 API 调用创建独立测试邮箱,邮件地址即时生成,持久存储,不会过期。
Register a Webhook endpoint to receive parsed OTP JSON the instant mail arrives — or use waitForOtp() to poll programmatically.
注册 Webhook 端点,邮件到达时立即推送解析后的 OTP JSON;或使用 waitForOtp() 方法轮询等待。
Poll via GET /messages or register a Webhook URL for instant push on mail arrival. Both return clean JSON.
使用 GET /messages 轮询,或注册 Webhook URL 在邮件到达时即时触发。两种模式均返回清洁的 JSON。
HTML emails are parsed server-side. You receive {"code": "382917", "expires_in": 540} — no regex needed.
HTML 邮件在服务端自动解析,你拿到的是 {"code": "382917", "expires_in": 540},无需自己写正则。
No rate limits on read operations. 100 concurrent test instances — API stays stable and responsive. 读取操作无速率限制。100 个并发测试实例同时运行,API 稳定响应,不封号不限速。
Unlike disposable inboxes, GridInbox test mailboxes persist. Reuse them in regression tests and retain full email history. 不同于临时邮箱,GridInbox 测试邮箱持久有效。可复用于回归测试,历史邮件保留可查。
{
"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
}
}
Automate signup → OTP → account activation flows in CI/CD. Works with Playwright, Cypress, and Selenium. 在 CI/CD 流水线中自动测试邮件注册、验证码输入、账号激活全流程。支持 Playwright/Cypress/Selenium。
Give LangChain or AutoGPT agents real mailboxes for platform registration and verification — fully unattended. 为 LangChain、AutoGPT 等 AI Agent 提供真实的邮箱用于平台注册和验证,全程无人工干预。
Subscribe to industry newsletters and price reports from multiple sources. Programmatically extract content for market analysis. 向多个来源订阅行业通讯和价格报告,程序化抓取邮件内容用于市场分析和竞品监控。
Set up alert inboxes for production systems. Trigger monitoring workflows via Webhook with zero-delay response. 为生产系统设置告警邮箱,通过 Webhook 实时触发监控流程,确保关键邮件通知零延迟响应。
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.
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.
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.
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.
"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 个,完全没问题。"
"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 里的邮件验证终于稳定了。"