Disposable Email API
for Developers
Create temporary inboxes, receive emails, and detect verification codes programmatically. Built for automated testing, CI/CD pipelines, and app integrations.
Quick Start
Get up and running in minutes. Create an inbox, poll for emails, and extract verification codes.
Create a Temporary Inbox
curl -X POST https://openinbox.io/api/inbox \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json"
# Response:
{
"id": "abc123",
"email": "[email protected]",
"expires_at": "2025-01-02T22:00:00Z",
"created_at": "2025-01-02T21:00:00Z"
}Retrieve Emails
curl https://openinbox.io/api/emails/abc123 \
-H "Authorization: Bearer YOUR_API_KEY"
# Response:
{
"emails": [
{
"id": "email_001",
"from": "[email protected]",
"subject": "Verify your email",
"text_body": "Your code is 482910",
"received_at": "2025-01-02T21:05:00Z",
"is_read": false
}
]
}Clean Up
curl -X DELETE https://openinbox.io/api/inbox/abc123 \ -H "Authorization: Bearer YOUR_API_KEY" # Response: 204 No Content
Built for Developers
Common use cases for the OpenInbox API
Automated Testing
Use in Cypress, Playwright, or Selenium tests to verify email flows end-to-end.
CI/CD Pipelines
Create disposable inboxes in your CI pipeline and verify signup/reset flows.
OTP Verification
Receive and extract OTP codes programmatically for test automation.
App Integration
Build temporary email features into your own application or SaaS product.
Security Testing
Test email-based attack vectors and security flows in a sandboxed environment.
Webhook Testing
Receive email notifications and parse them to test your webhook handlers.
API Features
RESTful Design
Clean, predictable REST endpoints with JSON responses. Easy to integrate with any language or framework.
API Key Auth
Secure your requests with API key authentication. Manage keys from your dashboard.
Rate Limiting
Fair usage with generous limits. Free tier: 100 req/day, Pro: 3,000/day, Business: 10,000/day.
Webhook Support
Get real-time notifications when emails arrive via webhook callbacks (Pro+ plans).
Attachment Support
Receive and download email attachments via the API. Up to 25MB per email.
Full Documentation
Comprehensive API docs with examples in cURL, JavaScript, Python, and more.
API Pricing
Start free, upgrade when you need more
Pro
$6.99/mo
3,000 req/day
- 10 active inboxes
- Full API access
- Webhook support
- Priority support
Business
$14.99/mo
10,000 req/day
- Unlimited inboxes
- Full API access
- Custom domains
- Dedicated support
Start Building with the Temp Email API
Create your first inbox in seconds. No credit card required.