Temp Postal API
Integrate temporary email functionality into your applications with our powerful, developer-friendly API. Simple, fast, and reliable.
RESTful API
Simple HTTP requests with JSON responses
Real-time
Instant email generation and retrieval
Secure
API key authentication and rate limiting
Global CDN
Fast response times worldwide
API Playground
Test Temp Postal API endpoints with your API key
Rate Limit Usage
Premium250 / 1,000
25.0% used this month
Business12,000 / 50,000
24.0% used this month
Enterprise45,000 / 1,000,000
4.5% used this month
POST /emails
Create a new temporary email address
Request
curl -X POST https://api.temppostal.com/v1/emails \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"domain": "temppostal.com", "prefix": "custom"}'Response
{
"id": "12345",
"email": "custom@temppostal.com",
"domain": "temppostal.com",
"created_at": "2024-01-15T10:30:00Z",
"expires_at": "2024-01-16T10:30:00Z"
}GET /emails/{id}/messages
Retrieve messages for a specific email address
Request
curl -X GET https://api.temppostal.com/v1/emails/12345/messages \
-H "Authorization: Bearer YOUR_API_KEY"Response
{
"messages": [
{
"id": "msg_001",
"from": "sender@example.com",
"to": "custom@temppostal.com",
"subject": "Welcome!",
"body": "Hello, welcome to our service!",
"received_at": "2024-01-15T11:00:00Z"
}
],
"total": 1
}DELETE /emails/{id}
Delete a temporary email address and all its messages
Request
curl -X DELETE https://api.temppostal.com/v1/emails/12345 \
-H "Authorization: Bearer YOUR_API_KEY"API Access
Ready to Build?
Get your API key, start building in minutes, and scale up when you need more throughput.
REST API Webhooks Team access