Skip to content

Developer API

Programmatically create inboxes, receive webhooks, and manage disposable identities.

No personal data in requests or responses
For Developers

API Access for Developers

Automate email creation, verification, and testing with our REST API. Perfect for QA teams, bot developers, and SaaS platforms.

Developer Plan

For automated testing & integrations

$19.99/month
10,000 email creations per month
Real-time webhook callbacks
Custom domain support
Priority API rate limits
Developer documentation
Email + SMS verification APIs

Quick start:

curl -X POST https://api.burnerboxx.com/v1/inboxes \
  -H "Authorization: Bearer YOUR_API_KEY"

Purchase the Developer Plan, then create an account with the same email to generate your API key.

Embeddable Widget

Add a "Get a free burner email" box to any website. Visitors generate and copy a burner email without leaving the page.

Embed Code
<!-- Burner Boxx widget -->
<div data-burnerboxx-widget></div>
<script src="https://burnerboxx.com/widget.js" async></script>
API Endpoints
POST/v1/inboxes
GET/v1/inboxes/{id}
GET/v1/inboxes/{id}/emails
DELETE/v1/inboxes/{id}
POST/v1/webhooks

Code Examples

Create Temporary Inbox (cURL)
curl -X POST https://api.burnerboxx.com/v1/inboxes \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"duration_minutes": 60}'
List Emails (JavaScript)
fetch('https://api.burnerboxx.com/v1/inboxes/{id}/emails', {
  headers: { 'Authorization': 'Bearer YOUR_API_KEY' }
}).then(r => r.json())
Delete Inbox (Python)
import requests
requests.delete(
  'https://api.burnerboxx.com/v1/inboxes/{id}',
  headers={'Authorization': 'Bearer YOUR_API_KEY'}
)
Quick Start: Create + Poll (Python)
import requests, time

BASE = "https://api.burnerboxx.com/v1"
HEADERS = {"Authorization": "Bearer YOUR_API_KEY"}

# 1. Create a 10-minute inbox
resp = requests.post(f"{BASE}/inboxes", json={"duration_minutes": 10}, headers=HEADERS)
inbox = resp.json()
print(f"Inbox ready: {inbox['email']}")

# 2. Poll for incoming emails
for _ in range(60):
    emails = requests.get(f"{BASE}/inboxes/{inbox['id']}/emails", headers=HEADERS).json()
    if emails:
        print(f"Got email from: {emails[0]['from_address']}")
        break
    time.sleep(10)
Webhook Registration (JavaScript)
// Register a webhook to receive real-time email notifications
fetch('https://api.burnerboxx.com/v1/webhooks', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    url: 'https://yourapp.com/webhooks/burnerboxx',
    events: ['email.received']
  })
}).then(r => r.json())

// Your webhook receives:
// { event: 'email.received', inbox_id: '...', from: '...', subject: '...' }
Go SDK Example
package main

import (
  "bytes"
  "encoding/json"
  "fmt"
  "net/http"
)

func main() {
  body, _ := json.Marshal(map[int]int{"duration_minutes": 60})
  req, _ := http.NewRequest("POST",
    "https://api.burnerboxx.com/v1/inboxes",
    bytes.NewBuffer(body))
  req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
  req.Header.Set("Content-Type", "application/json")
  resp, _ := http.DefaultClient.Do(req)
  fmt.Println(resp.Status)
}