MailEgzz API Documentation

mail GET /api/v1/inbox

info The GET /api/v1/inbox endpoint retrieves a list of email messages stored in a mailbox.

Each message contains metadata such as message ID, sender address, subject, timestamp, and a cleaned text field extracted from the email body for easy OTP detection.

This endpoint supports pagination using the page and page_size parameters.

tune Parameters

Name	Type	Required	Description
mailbox	string	check_circle	Target mailbox email address (example: test@mailegzz.site)
page	integer	-	Page number for pagination (default: 1)
page_size	integer	-	Number of messages per page (default: 50, max: 100)

terminal cURL

code JavaScript

integration_instructions Python

curl "https://mailegzz.site/api/v1/inbox?mailbox=test@mailegzz.site&page=1&page_size=50"

fetch("https://mailegzz.site/api/v1/inbox?mailbox=test@mailegzz.site")
  .then(res => res.json())
  .then(console.log);

import requests

res = requests.get(
  "https://mailegzz.site/api/v1/inbox",
  params={
    "mailbox": "test@mailegzz.site",
    "page": 1,
    "page_size": 50
  }
)

print(res.json())

data_object Response

{
  "address": "test@mailegzz.site",
  "page": 1,
  "page_size": 50,
  "count": 2,
  "messages": [
    {
      "id": "12",
      "mailbox": "test@mailegzz.site",
      "from": "noreply@github.com",
      "subject": "Verify your email",
      "date": "2026-01-10T07:32:11Z",
      "size": 1342,
      "text": "Your verification code is 834291"
    }
  ]
}

drafts GET /api/v1/message/{id}

info The GET /api/v1/message/{id} endpoint retrieves the full details of a specific email message.

Unlike the /api/v1/inbox endpoint, this response includes the full email body and a cleaned text field that is optimized for OTP extraction and automation.

tune Parameters

Name	Type	Required	Description
id	integer	check_circle	Message ID obtained from `/api/v1/inbox`
mailbox	string	check_circle	Target mailbox email address (example: test@mailegzz.site)

terminal cURL

code JavaScript

integration_instructions Python

curl "https://mailegzz.site/api/v1/message/12?mailbox=test@mailegzz.site"

fetch("https://mailegzz.site/api/v1/message/12?mailbox=test@mailegzz.site")
  .then(res => res.json())
  .then(console.log);

import requests

res = requests.get(
  "https://mailegzz.site/api/v1/message/12",
  params={"mailbox": "test@mailegzz.site"}
)

print(res.json())

data_object Response

{ "success": true, "data": { "id": 12, "mailbox": "test@mailegzz.site", "from": "noreply@github.com", "subject": "Verify your email", "date": "2026-01-10 07:32:11", "text": "Your verification code is 834291", "body": "

Your verification code is 834291

" } }

delete_forever DELETE /api/v1/message/{id}

warning The DELETE /api/v1/message/{id} endpoint permanently removes a specific email message from a mailbox.

Once deleted, the message cannot be recovered. This operation only affects the selected message ID and does not delete other messages in the mailbox.

tune Parameters

Name	Type	Required	Description
id	integer	check_circle	Message ID obtained from `/api/v1/inbox`
mailbox	string	check_circle	Target mailbox email address (example: test@mailegzz.site)

terminal cURL

code JavaScript

integration_instructions Python

curl -X DELETE \
"https://mailegzz.site/api/v1/message/12?mailbox=test@mailegzz.site"

fetch("https://mailegzz.site/api/v1/message/12?mailbox=test@mailegzz.site", {
  method: "DELETE"
})
.then(res => res.json())
.then(console.log);

import requests

res = requests.delete(
  "https://mailegzz.site/api/v1/message/12",
  params={"mailbox": "test@mailegzz.site"}
)

print(res.json())

data_object Response

{
  "success": true,
  "message": "Message deleted successfully",
  "data": {
    "id": 12,
    "mailbox": "test@mailegzz.site"
  }
}

move_to_inbox POST /api/v1/receive

info Public endpoint used to deliver incoming emails into a MailEgzz mailbox.

Commonly used by bots, webhooks, or external services. Supports full HTML content and optional message identifiers.

tune Parameters (JSON Body)

Name	Type	Required	Description
to	string	check_circle	Target mailbox address
from	string	check_circle	Sender email address
subject	string	-	Email subject
body	string	-	HTML email body
msg_id	string	-	Optional unique message ID

terminal cURL

code JavaScript

integration_instructions Python

curl -X POST https://mailegzz.site/api/v1/receive \
-H "Content-Type: application/json" \
-d '{
  "to": "test@mailegzz.site",
  "from": "bot@service.com",
  "subject": "Hello API",
  "body": "Hello MailEgzz"
}'

fetch("https://mailegzz.site/api/v1/receive", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    to: "test@mailegzz.site",
    from: "bot@service.com",
    subject: "Hello API",
    body: "Hello MailEgzz"
  })
})
.then(r => r.json())
.then(console.log);

import requests

requests.post(
  "https://mailegzz.site/api/v1/receive",
  json={
    "to": "test@mailegzz.site",
    "from": "bot@service.com",
    "subject": "Hello API",
    "body": "Hello MailEgzz"
  }
).json()