aiomailtm

A small async Python client for the mail.tm disposable email API.

Installation

pip install aiomailtm

Usage

import asyncio
from aiomailtm import Aiomailtm


async def main():
    async with Aiomailtm() as client:
        account = await client.create_account()
        if not account.success:
            print(account.message)
            return

        print("Email:", account.email)
        print("Token:", account.token)

        message = await client.get_latest_email()
        if message.success:
            print("From:", message.from_address)
            print("Subject:", message.subject)
            print("Text:", message.text)
        else:
            print(message.message)


asyncio.run(main())

API

Aiomailtm(password="Aiomailtm@123", proxy=None)

Create a client. Pass an optional proxy URL and a custom password.

• await create_account() -> AccountResult — create a random account and authenticate the client.
• await get_latest_email() -> MessageResult — fetch the most recent email for the current account.
• await get_domain() -> str | None — return the first available mail.tm domain.
• await close() — close the underlying HTTP client (handled automatically with async with).

AccountResult

MessageResult

License

MIT