AuvaDocs
Sign in

Disposable Inboxes

Create temporary email inboxes that auto-destroy after 1 hour. Perfect for testing, privacy, and avoiding spam.

Create an Inbox

text
POST https://auva.email/api/inboxes
Content-Type: application/json

{
  "prefix": "signup-test"    // Optional
}

Response:

text
{
  "id": "inbox_xyz789",
  "email": "signup-test-k3m1@auva.email",
  "expiresAt": "2024-03-15T11:30:00.000Z",
  "linked": false,
  "messages": []
}

Get Inbox Messages

text
GET https://auva.email/api/inboxes/{id}/messages

Response:

text
{
  "messages": [
    {
      "id": "msg_001",
      "from": "noreply@example.com",
      "subject": "Verify your email",
      "preview": "Click the link below to verify...",
      "html": "<html>...</html>",
      "receivedAt": "2024-03-15T10:35:22.000Z"
    }
  ]
}

Read a Specific Message

text
GET https://auva.email/api/inboxes/{inboxId}/messages/{messageId}

Returns the full email content including HTML body, plain text, headers, and attachments.

Delete an Inbox

text
DELETE https://auva.email/api/inboxes/{id}

You don't need to manually delete inboxes: they auto-expire after 1 hour. But you can delete them early if needed.

Inbox Lifecycle

text
Created → Active (receiving emails) → Expired (1h TTL) → Deleted
                                       ↑
                                       └── Or manually deleted

Linked Inboxes

If you're signed in with an Auva Account, you can link an inbox to preserve it beyond the TTL:

text
POST https://auva.email/api/inboxes/{id}/link
Authorization: Bearer YOUR_ACCESS_TOKEN

Linked inboxes: