Simple, Easy To implement, Cheap.

Welcome to Go6 Mail

Please choose an option to continue

Add and manage your custom domains

Domain Management

Please login to manage your domains

Go6 Mail © 2025 | Domain Management

API Documentation

Welcome to the Go6 Mail API documentation.

API Base URL

Get the current VPS URL first:

GET https://go6gen.pythonanywhere.com/vps_url

Response:
{
    "vps_url": "https://current-vps-url.go6mail.com"
}

Then use the returned VPS URL for all API requests. For example:

# Get VPS URL
response = requests.get("https://go6gen.pythonanywhere.com/vps_url")
vps_url = response.json()["vps_url"]

# Use it for API requests
response = requests.post(f"{vps_url}/create", json={
    "api_key": "Go6Mail-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "domain": "default"
})

Note: The VPS URL may change as we change from VPS.

POST /create

Creates a new temporary email inbox. Requires sufficient balance on your API key. The system will automatically deduct the current price from your balance upon successful creation.

Request Payload

Parameter Type Required Description Default
api_key string Required Your Go6 Mail API key -
domain string Optional Domain for the email address. Use "default" for random domain, or specify a specific default domain or your custom domain. You can provide either just the domain name (example.com) or full email address (username@example.com). "default"
username string Optional Custom username for the inbox. Must be 3-32 alphanumeric characters. If not provided, a random username will be generated. Random username
password string Optional Password for accessing the inbox. If not provided, a random password will be generated. Random hex string 
POST {vps_url}/create
Content-Type: application/json

{
    "api_key": "Go6Mail-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "domain": "default",
    "password": "mysecretpassword123"
}
POST {vps_url}/create
Content-Type: application/json

{
    "api_key": "Go6Mail-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "domain": "go6mail.com",
    "username": "john123"
}
POST {vps_url}/create
Content-Type: application/json

{
    "api_key": "Go6Mail-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "domain": "username@go6mail.com",
    "username": "customuser",
    "password": "mypassword"
}

Response

Success Response (201 Created)

{
    "status": "success",
    "address": "john12345@example.com",
    "username": "john12345",
    "domain": "example.com",
    "password": "mysecretpassword123",
    "price": 0.05
}

Error Response (401 Unauthorized)

{
    "status": "error",
    "error": "Invalid API key"
}

Error Response (402 Payment Required)

{
    "status": "error",
    "error": "Insufficient balance"
}

Error Response (400 Bad Request)

{
    "status": "error",
    "error": "Username must be 3-32 alphanumeric characters"
}

Error Response (409 Conflict)

{
    "status": "error",
    "error": "Username already taken"
}

Error Response (400 Bad Request)

{
    "status": "error",
    "error": "Domain not available. Use one of your domains or a default domain"
}
GET /inbox/{name}

Retrieves emails from a specific inbox. This endpoint automatically extracts Discord verification URLs from email bodies and returns them in a clean format. 

GET {vps_url}/inbox/john12345?password=mysecretpassword123

GET {vps_url}/inbox/john12345
Authorization: mysecretpassword123

Response

Success Response with URLs (200 OK)

{
    "status": "success",
    "verification_urls": [
        "https://click.discord.com/ls/click?upn=xxxxxxxxxxxx",
        "https://discord.com/verify?token=xxxxxxxxxxxx"
    ],
    "message": "Discord verification URLs found",
    "email_count": 3,
    "url_count": 2
}

Success Response without URLs (200 OK)

{
    "status": "no_urls",
    "message": "No Discord verification URLs found in any emails",
    "email_count": 3
}

Error Response (401 Unauthorized)

{
    "status": "error",
    "error": "Invalid password for this inbox"
}

Error Response (404 Not Found)

{
    "status": "inbox not found"
}
GET /complete_inbox/{name}

Retrieves all email details from a specific inbox, including sender, subject, body, and timestamps. This returns the complete email data without URL extraction. 

GET {vps_url}/complete_inbox/john12345?password=mysecretpassword123

GET {vps_url}/complete_inbox/john12345
Authorization: mysecretpassword123

Response

Success Response (200 OK)

{
    "status": "success",
    "inbox_name": "john12345",
    "total_emails": 3,
    "emails": [
        {
            "id": 1,
            "sender": "noreply@discord.com",
            "subject": "Verify your Discord account",
            "body": "Please click here to verify: https://click.discord.com/verify",
            "received_at": 1678901234.567,
            "password": "mysecretpassword123"
        },
        {
            "id": 2,
            "sender": "service@example.com",
            "subject": "Welcome",
            "body": "Your account has been created",
            "received_at": 1678901200.123,
            "password": "mysecretpassword123"
        }
    ]
}

Error Response (401 Unauthorized)

{
    "status": "error",
    "error": "Invalid password for this inbox"
}

Error Response (404 Not Found)

{
    "status": "inbox not found"
}
GET /get_all_inboxes

Retrieves all inboxes created by your API key, including email addresses, passwords, and inbox statistics. 

GET {vps_url}/get_all_inboxes?api_key=Go6Mail-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Response

Success Response (200 OK)

{
    "status": "success",
    "api_key": "Go6Mail-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "total_inboxes": 2,
    "inboxes": [
        {
            "email_address": "john12345@example.com",
            "username": "john12345",
            "password": "mysecretpassword123",
            "total_emails": 3,
            "created_at": 1678901200.123,
            "last_email_at": 1678901234.567,
            "exists": true
        },
        {
            "email_address": "alice789@go6mail.com",
            "username": "alice789",
            "password": "anotherpassword456",
            "total_emails": 0,
            "exists": false
        }
    ]
}

Error Response (400 Bad Request)

{
    "status": "error",
    "error": "API key required"
}

Error Response (401 Unauthorized)

{
    "status": "error",
    "error": "Invalid API key"
}

Important Notes

  • Always get the VPS URL from https://go6gen.pythonanywhere.com/vps_url before making API requests.
  • Each inbox creation costs a small fee (check current price via /price endpoint).
  • Keep your API key secure. They cannot be recovered if lost.
  • Inboxes and emails are forever, BUT may be automatically cleaned up after some time if theres no activity for a long time.
  • When creating an inbox with "domain": "default", a random default domain will be selected. You can also specify a specific default domain like "go6mail.com" to use that particular domain.
  • You can provide domain as either just the domain name ("example.com") or full email address ("username@example.com"). If using full email, only the domain part will be used.
  • Custom usernames must be 3-32 alphanumeric characters. If a username is already taken, the creation will fail.
  • Our VPS URL may change when we change VPS. Your applications should always fetch it from our secondary api.

Go6 Mail API Documentation © 2025

For support, join our Discord server

Your Mails

View and manage all your email inboxes

Go6 Mail © 2025 | Total Inboxes: 0

Loading...

Loading mailbox...