Skip to content
TempMailHush Docs

Mailboxes

Mailboxes

Section titled “Mailboxes”

Mailboxes are short-lived, receive-only inboxes. Use them for verification emails, QA flows, signup tests, and low-risk one-time messages.

Create mailbox

Section titled “Create mailbox”
POST /api/v1/mailboxes
Terminal window
curl -X POST https://tempmailhush.com/api/v1/mailboxes \
  -H "X-API-Key: sk-your_api_key"

Get mailbox

Section titled “Get mailbox”
GET /api/v1/mailboxes/{mailbox_id}
Terminal window
curl https://tempmailhush.com/api/v1/mailboxes/{mailbox_id} \
  -H "X-API-Key: sk-your_api_key"

Extend mailbox

Section titled “Extend mailbox”
POST /api/v1/mailboxes/{mailbox_id}/extend

Extend a mailbox using the account mailbox lifetime entitlement.

Terminal window
curl -X POST https://tempmailhush.com/api/v1/mailboxes/{mailbox_id}/extend \
  -H "X-API-Key: sk-your_api_key"

Switch mailbox

Section titled “Switch mailbox”
POST /api/v1/mailboxes/{mailbox_id}/switch

Create a replacement mailbox and delete the old mailbox.

Terminal window
curl -X POST https://tempmailhush.com/api/v1/mailboxes/{mailbox_id}/switch \
  -H "X-API-Key: sk-your_api_key"

Delete mailbox

Section titled “Delete mailbox”
DELETE /api/v1/mailboxes/{mailbox_id}

Delete a mailbox and its stored messages.

Terminal window
curl -X DELETE https://tempmailhush.com/api/v1/mailboxes/{mailbox_id} \
  -H "X-API-Key: sk-your_api_key"