Messages

Messages

Message endpoints operate inside a mailbox. Most test flows poll the message list until the expected email arrives, then read the message body or HTML.

List messages

GET /api/v1/mailboxes/{mailbox_id}/messages

List messages received by a mailbox, newest first.

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

Get message

GET /api/v1/mailboxes/{mailbox_id}/messages/{message_id}

Read the parsed text body and metadata for one message.

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

HTML preview

GET /api/v1/mailboxes/{mailbox_id}/messages/{message_id}/html

Read the sanitized HTML body for a message.

curl https://tempmailhush.com/api/v1/mailboxes/{mailbox_id}/messages/{message_id}/html \
  -H "X-API-Key: sk-your_api_key"

Raw source

GET /api/v1/mailboxes/{mailbox_id}/messages/{message_id}/source

Download the raw RFC822 email source for a message.

curl https://tempmailhush.com/api/v1/mailboxes/{mailbox_id}/messages/{message_id}/source \
  -H "X-API-Key: sk-your_api_key"

Delete message

DELETE /api/v1/mailboxes/{mailbox_id}/messages/{message_id}

Delete one message from a mailbox.

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