WH Studio builds refined websites for ambitious brands.
Visit WH Studio
Temp Postal
Home/API/examples

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

Node.js Example

const axios = require('axios');

const api = axios.create({
  baseURL: 'https://api.temppostal.com/v1',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  }
});

// Create a temporary email
async function createTempEmail() {
  try {
    const response = await api.post('/emails', {
      domain: 'temppostal.com',
      prefix: 'myapp-user'
    });
    console.log('Email created:', response.data.email);
    return response.data;
  } catch (error) {
    console.error('Error:', error.response.data);
  }
}

// Get messages
async function getMessages(emailId) {
  try {
    const response = await api.get('/emails/' + emailId + '/messages');
    return response.data.messages;
  } catch (error) {
    console.error('Error:', error.response.data);
  }
}
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