TempMail.so Python SDK

A Python SDK for interacting with the TempMail.so temporary email service API.

Features

• Create and manage temporary email inboxes
• List available email domains
• Retrieve and manage emails
• Full API coverage with simple interface
• Type hints support
• MIT licensed

Installation

pip install temp-mail-so

Quick Start

from temp_mail_so import TempMailSo

# Initialize client
client = TempMailSo(
    rapid_api_key="your_rapid_api_key_here",
    auth_token="your_auth_token_here"
)

# Create a temporary inbox
inbox = client.create_inbox(
    address="test123",  # Email prefix
    domain="mailnuo.com",  # Domain
    lifespan=300  # Inbox lifespan in seconds (0 for permanent)
)

# List all emails in an inbox
emails = client.list_emails(inbox_id="your_inbox_id")

API Reference

TempMailSo Class

__init__(rapid_api_key: str, auth_token: str)

Initialize the TempMail client with your API credentials.

list_domains() -> Dict

Get a list of available email domains.

create_inbox(address: str, domain: str, lifespan: int = 0) -> Dict

Create a new temporary email inbox.

• address: Custom email prefix
• domain: Email domain
• lifespan: Inbox lifespan in seconds (0, 300, 600, 900, 1200, 1800). 0 means permanent.

list_inboxes() -> Dict

Get a list of all inboxes associated with the account.

delete_inbox(inbox_id: str) -> Dict

Delete a specific inbox.

list_emails(inbox_id: str) -> Dict

Get all emails in a specific inbox.

get_email(inbox_id: str, email_id: str) -> Dict

Get details of a specific email.

delete_email(inbox_id: str, email_id: str) -> Dict

Delete a specific email.

Requirements

• Python 3.6+
• requests library

License

This project is licensed under the MIT License - see the LICENSE file for details.

Author

TempMail.so

Version

1.0.0

Last updated: 2025-01-01