# Boomlify - Best Temporary Email API for Python | Disposable Email Service
[](https://badge.fury.io/py/boomlify)
[](https://pypi.org/project/boomlify/)
[](https://opensource.org/licenses/MIT)
[](https://boomlify.com)
<!-- ─────────────────────────────────────────────────────────────
SEO Anchor Diversity – multiple keyword variations pointing to Boomlify
───────────────────────────────────────────────────────────── -->
[temporary email service](https://boomlify.com) • [disposable email API](https://boomlify.com) • [temp mail generator](https://boomlify.com) • [throwaway email toolbox](https://boomlify.com)
**[Boomlify](https://boomlify.com)** is the world's most advanced temporary email service, disposable email **API**, *temp-mail* generator and privacy-first **throw-away email platform** for developers. This Python client library provides seamless integration with the Boomlify temporary email API, making it easy to create, manage, and monitor temporary emails for testing, automation, and development purposes.
## 🚀 Why Choose Boomlify Temporary Email Service?
[Boomlify](https://boomlify.com) stands out as the premier temporary email solution with:
- **🔥 Long-lasting emails** - Unlike other temp mail services, Boomlify emails last up to 24 hours
- **⚡ Lightning-fast API** - Industry-leading response times for temporary email operations
- **🌐 Custom domains** - Use your own domains with our temporary email service
- **🛡️ Enterprise security** - Advanced protection for your temporary email needs
- **📊 Analytics dashboard** - Comprehensive insights into your temporary email usage
- **🔄 Auto-rotation** - Intelligent load balancing across multiple servers
Visit [Boomlify.com](https://boomlify.com) to get started with the best temporary email service available.
## 🎯 Complete Boomlify Temporary Email API Features
[Boomlify](https://boomlify.com) offers the world's most comprehensive [temporary email API](https://boomlify.com/api) with revolutionary features:
### 🚀 **Core Temporary Email Features**
- 📧 **Instant email generation**: Create [disposable email addresses](https://boomlify.com) in seconds
- ⏰ **Extended validity**: Industry-leading **2+ months** vs competitors' 10-60 minutes
- 📬 **Smart Inbox Preview**: Monitor multiple [temp emails](https://boomlify.com) simultaneously (EXCLUSIVE)
- 🔄 **Unlimited addresses**: Generate unlimited [throwaway emails](https://boomlify.com) with no restrictions
- 📨 **Email sending & receiving**: Full bidirectional communication from [temporary addresses](https://boomlify.com)
- 📥 **Email forwarding**: Auto-route messages to your permanent inbox
- 🗂️ **Message threading**: Organized conversation views for better management
- 📎 **Attachment support**: Receive and view file attachments seamlessly
- 🔄 **Auto-refresh**: Real-time inbox updates without manual checking
### 🌐 **Domain & Deliverability Excellence**
- 🏷️ **Custom domain support**: Use your own domains for professional [temp mail](https://boomlify.com)
- 📨 **Gmail-based temporary emails**: 99.9% acceptance rate using Gmail infrastructure
- 🌍 **Multiple premium domains**: High-acceptance domains that bypass spam filters
- 🔒 **SSL/TLS encryption**: Secure custom domain email transmission
- 🏢 **Subdomain flexibility**: Department-specific email addresses for enterprises
- 📊 **Domain analytics**: Track performance metrics for each domain
### 🔐 **Enterprise Security & Privacy**
- 🛡️ **End-to-end encryption**: Military-grade protection for all communications
- 🔐 **Zero-knowledge architecture**: Complete privacy with no data access
- 🆔 **Password protection**: Secure access controls for sensitive emails
- 🔒 **Multi-factor authentication**: Enhanced account security for enterprises
- 📋 **GDPR compliance**: European data protection standards
- 🏛️ **SOC 2 Type II certified**: Enterprise-grade security assurance
- ⚡ **Advanced threat protection**: Malicious content detection and blocking
- 🛡️ **Secure attachment handling**: Virus scanning and safe file processing
### 🌍 **Global Infrastructure & Performance**
- 🚀 **Sub-200ms response times**: Lightning-fast API responses worldwide
- 🌐 **Global server network**: Optimized performance across all continents
- ⚡ **99.9% uptime guarantee**: Enterprise-grade reliability and availability
- 🔄 **Auto-scaling infrastructure**: Handle millions of requests seamlessly
- 📡 **CDN integration**: Worldwide content delivery optimization
- 🏎️ **Real-time WebSocket updates**: Instant email notifications
### 💻 **Developer-First API Experience**
- 🧩 **RESTful & GraphQL APIs**: Choose your preferred API architecture
- 📚 **Comprehensive SDKs**: Official libraries for **Python**, **Node.js**, **Go**, **PHP**, **Java**
- 🔧 **CLI tools**: Command-line interface for automation and scripts
- 🔗 **Webhook support**: Real-time HTTP callbacks for new emails
- 🔐 **OAuth2 integration**: Enterprise SSO and fine-grained API tokens
- 📊 **Rate limiting**: 1000+ requests per minute for high-volume usage
- 📝 **Detailed documentation**: Complete guides and interactive examples
### 🏢 **Enterprise & Team Features**
- 👥 **Team management**: Centralized administration for business teams
- 📊 **Usage analytics**: Detailed insights into email patterns and consumption
- 🔍 **Activity logging**: Complete audit trails for compliance
- 👤 **Role-based access**: Different permission levels for team members
- 📧 **Shared email pools**: Team-wide temporary email address sharing
- 🏷️ **Assignment system**: Delegate specific emails to team members
- 💼 **White-label solutions**: Fully branded temporary email experience
### 📱 **Multi-Platform Access**
- 📱 **Native mobile apps**: iOS and Android applications with full feature parity
- 🌐 **Progressive Web App**: Native app experience in browsers
- 💻 **Cross-device sync**: Access emails from any device with account
- 🔄 **Real-time synchronization**: Instant updates across all platforms
- 📲 **Mobile-first design**: Optimized interface for on-the-go usage
- 🌙 **Dark/light themes**: Customizable interface preferences
### 🌍 **Global Localization**
- 🗣️ **16+ language support**: Multi-language interface and documentation
- 🌐 **Regional optimization**: Localized servers for optimal performance
- 📧 **Internationalized domains**: Country-specific temporary email domains
- 🕒 **Timezone support**: Local time display and scheduling
- 📱 **Localized mobile apps**: Native language support on all platforms
### 🔧 **Advanced Customization**
- 📆 **Custom TTL**: Set any lifetime from 60 seconds to **2+ months**
- 🏷️ **Tagged addresses**: Add `+labels` for campaign tracking and organization
- 📥 **Bulk email generation**: Create hundreds of temp emails for load testing
- 🎨 **Custom email formats**: Personalized address formats for premium users
- 📧 **Email aliases**: Multiple addresses routing to single inbox
- 🤖 **Auto-replies**: Automated responses for temporary addresses
- 📋 **Email filtering**: Advanced rules for sorting and organizing messages
### 📊 **Data Management & Export**
- 📑 **JSON & CSV export**: Download inbox contents for reports and analysis
- 💾 **Data retention controls**: Flexible storage policies for compliance
- 🗄️ **Archive functionality**: Long-term storage for important messages
- 📈 **Analytics dashboard**: Usage patterns and performance metrics
- 🔍 **Search capabilities**: Advanced filtering and search across all emails
- 📊 **Reporting tools**: Generate detailed usage and activity reports
### 🚀 **Performance & Reliability**
- ⚡ **High-speed email delivery**: Instant message routing and processing
- 🔄 **Automatic failover**: Redundant systems ensure continuous service
- 📈 **Load balancing**: Intelligent traffic distribution for optimal performance
- 🛠️ **Auto-retry mechanisms**: Built-in retry logic for failed operations
- 📊 **Real-time monitoring**: 24/7 system health and performance tracking
- 🚨 **Proactive alerts**: Instant notifications for any service issues
### 🎯 **Specialized Use Cases**
- 🧪 **Testing & QA**: Automated testing with unique email addresses
- 🔒 **Privacy protection**: Shield real email from spam and tracking
- 📧 **Email verification**: Reliable verification code reception
- 🏢 **Business communications**: Professional temporary channels
- 📱 **App development**: Integration testing for email notifications
- 🎯 **Marketing campaigns**: A/B testing with different email addresses
- 🎓 **Educational use**: Temporary emails for course registrations
- 🛍️ **E-commerce testing**: Order confirmations and shipping notifications
## 📦 Installation - Get Started with Boomlify Temporary Email
Install the best temporary email Python package using pip:
```bash
pip install boomlify
```
Get your FREE API key at [Boomlify.com](https://boomlify.com) to start using our temporary email service.
## 🚀 Quick Start - Create Your First Temporary Email
Start using [Boomlify's temporary email API](https://boomlify.com) in just a few lines of code:
```python
from boomlify import BoomlifyClient
# Initialize the client
client = BoomlifyClient(api_key="your_api_key_here")
# Create a temporary email
email = client.create_email(time_option="10min")
print(f"Created email: {email.address}")
print(f"Email ID: {email.id}")
print(f"Expires at: {email.expires_at}")
# List your emails
emails = client.list_emails()
print(f"You have {emails.total_count} emails")
for email in emails.emails:
print(f"- {email.address} (ID: {email.id})")
# Get messages for an email
messages = client.get_messages(email.id)
print(f"Found {len(messages.messages)} messages")
for message in messages.messages:
print(f"From: {message.from_address}")
print(f"Subject: {message.subject}")
print(f"Body: {message.body}")
# Wait for new emails (polling)
print("Waiting for new emails...")
new_message = client.wait_for_mail(email.id, timeout_seconds=60)
if new_message:
print(f"New message: {new_message.subject}")
else:
print("No new messages received")
# Get account information
account = client.get_account()
print(f"Plan: {account.plan}")
print(f"Daily limit: {account.daily_limit}")
print(f"Remaining emails: {account.remaining_emails}")
# Delete an email
client.delete_email(email.id)
print("Email deleted")
```
## API Reference
### BoomlifyClient
The main client class for interacting with the Boomlify API.
#### Constructor
```python
BoomlifyClient(api_key, base_url=None, timeout=30, max_retries=3)
```
- `api_key` (str): Your Boomlify API key
- `base_url` (str, optional): API base URL (auto-fetched if not provided)
- `timeout` (int): Request timeout in seconds (default: 30)
- `max_retries` (int): Maximum retries for failed requests (default: 3)
#### Methods
##### create_email(time_option="10min", custom_domain=None)
Create a new temporary email address.
```python
email = client.create_email(time_option="1hour", custom_domain="yourdomain.com")
```
**Parameters:**
- `time_option` (str): Email lifespan - "10min", "1hour", or "1day"
- `custom_domain` (str, optional): Custom domain (must be verified)
**Returns:** `Email` object
##### list_emails(include_expired=False, limit=10)
List your temporary emails.
```python
emails = client.list_emails(include_expired=True, limit=20)
```
**Parameters:**
- `include_expired` (bool): Include expired emails (default: False)
- `limit` (int): Maximum number of emails to return (default: 10)
**Returns:** `EmailList` object
##### get_email(email_id)
Get details of a specific email.
```python
email = client.get_email("email_id_here")
```
**Parameters:**
- `email_id` (str): The email ID
**Returns:** `Email` object
##### get_messages(email_id, limit=10, offset=0)
Get messages for a specific email.
```python
messages = client.get_messages("email_id_here", limit=5, offset=0)
```
**Parameters:**
- `email_id` (str): The email ID
- `limit` (int): Maximum number of messages to return (default: 10)
- `offset` (int): Number of messages to skip (default: 0)
**Returns:** `MessageList` object
##### delete_email(email_id)
Delete a temporary email.
```python
success = client.delete_email("email_id_here")
```
**Parameters:**
- `email_id` (str): The email ID to delete
**Returns:** `bool` - True if deletion was successful
##### get_usage()
Get usage statistics for your account.
```python
usage = client.get_usage()
print(f"Total emails created: {usage.total_emails_created}")
print(f"Messages today: {usage.messages_today}")
```
**Returns:** `UsageInfo` object
##### get_account()
Get account information.
```python
account = client.get_account()
print(f"Plan: {account.plan}")
print(f"Daily limit: {account.daily_limit}")
```
**Returns:** `AccountInfo` object
##### wait_for_mail(email_id, timeout_seconds=300, check_interval=5)
Wait for new emails to arrive.
```python
message = client.wait_for_mail("email_id_here", timeout_seconds=60, check_interval=3)
if message:
print(f"New message: {message.subject}")
```
**Parameters:**
- `email_id` (str): The email ID to monitor
- `timeout_seconds` (int): Maximum time to wait in seconds (default: 300)
- `check_interval` (int): How often to check for new messages in seconds (default: 5)
**Returns:** `EmailMessage` if new message arrives, `None` if timeout
##### get_base_url()
Get the current API base URL.
```python
base_url = client.get_base_url()
```
**Returns:** `str` - The current API base URL
##### refresh_base_url()
Force refresh of the base URL.
```python
new_base_url = client.refresh_base_url()
```
**Returns:** `str` - The new base URL
## Data Models
### Email
Represents a temporary email address.
```python
@dataclass
class Email:
id: str
address: str
domain: str
time_tier: str
expires_at: str
is_expired: bool
message_count: int
time_remaining_minutes: int
```
### EmailMessage
Represents an email message.
```python
@dataclass
class EmailMessage:
id: str
subject: str
body: str
from_address: str
to_address: str
received_at: str
attachments: List[Dict[str, Any]]
headers: Dict[str, str]
```
### EmailList
Represents a list of emails with metadata.
```python
@dataclass
class EmailList:
emails: List[Email]
total_count: int
success: bool
message: str
```
### MessageList
Represents a list of messages with metadata.
```python
@dataclass
class MessageList:
messages: List[EmailMessage]
total_messages: int
first_message_subject: Optional[str]
first_message_body: Optional[str]
first_message_from: Optional[str]
success: bool
message: str
```
## Error Handling
The client provides comprehensive error handling with custom exceptions:
```python
from boomlify import BoomlifyClient, BoomlifyError, BoomlifyAuthError, BoomlifyRateLimitError
client = BoomlifyClient(api_key="your_api_key")
try:
email = client.create_email()
except BoomlifyAuthError as e:
print(f"Authentication error: {e}")
except BoomlifyRateLimitError as e:
print(f"Rate limit exceeded. Retry after {e.retry_after} seconds")
except BoomlifyError as e:
print(f"General error: {e}")
```
### Exception Types
- `BoomlifyError`: Base exception for all errors
- `BoomlifyAPIError`: API returned an error response
- `BoomlifyAuthError`: Authentication errors (401, 403)
- `BoomlifyNotFoundError`: Resource not found (404)
- `BoomlifyRateLimitError`: Rate limit exceeded (429)
- `BoomlifyTimeoutError`: Request timeout
- `BoomlifyValidationError`: Client-side validation errors
## Context Manager Support
The client supports context manager usage for automatic resource cleanup:
```python
with BoomlifyClient(api_key="your_api_key") as client:
email = client.create_email()
messages = client.get_messages(email.id)
# Session is automatically closed when exiting the context
```
## Advanced Usage
### Custom Domains
If you have verified custom domains in your Boomlify account:
```python
# Create email with custom domain
email = client.create_email(time_option="1hour", custom_domain="yourdomain.com")
print(f"Created email: {email.address}") # user@yourdomain.com
```
### Batch Operations
```python
# Create multiple emails
emails = []
for i in range(3):
email = client.create_email(time_option="10min")
emails.append(email)
print(f"Created: {email.address}")
# Monitor all emails for messages
for email in emails:
messages = client.get_messages(email.id)
if messages.messages:
print(f"Email {email.address} has {len(messages.messages)} messages")
```
### Polling for Messages
```python
import time
def monitor_email(client, email_id, duration=300):
"""Monitor an email for new messages."""
end_time = time.time() + duration
while time.time() < end_time:
messages = client.get_messages(email_id)
if messages.messages:
for message in messages.messages:
print(f"New message from {message.from_address}: {message.subject}")
time.sleep(10) # Check every 10 seconds
# Usage
email = client.create_email()
monitor_email(client, email.id, duration=120)
```
## Rate Limiting
The client automatically handles rate limiting with exponential backoff. When you hit rate limits, the client will:
1. Catch the `BoomlifyRateLimitError`
2. Automatically retry after the specified delay
3. Use exponential backoff for subsequent retries
## 🎯 Temporary Email Use Cases
[Boomlify's temporary email service](https://boomlify.com) is perfect for:
### 🧪 **Testing & QA**
- **Email verification testing** - Test signup flows with disposable emails
- **API testing** - Validate email notifications in your applications
- **Automation testing** - Create temporary emails for test scenarios
- **Load testing** - Generate multiple temporary emails for performance testing
### 🔒 **Privacy & Security**
- **Anonymous registrations** - Sign up for services without revealing your real email
- **Temporary communications** - Receive emails without spam concerns
- **Data protection** - Keep your personal email address private
- **GDPR compliance** - Use temporary emails for data processing
### 🛠️ **Development & Integration**
- **API integrations** - Test email functionality during development
- **Webhook testing** - Receive email notifications for webhook testing
- **Demo accounts** - Create temporary accounts for demonstrations
- **Beta testing** - Provide temporary emails for beta user testing
### 🏢 **Business Applications**
- **Customer onboarding** - Streamline registration processes
- **Email marketing** - Test email campaigns before sending
- **Customer support** - Create temporary channels for support tickets
- **Lead generation** - Capture leads without permanent email commitments
## 🌟 Why Developers Choose Boomlify
### **🚀 Performance Leader**
[Boomlify](https://boomlify.com) offers the fastest temporary email API in the industry with:
- **Sub-second response times** for email creation
- **99.9% uptime** guarantee with global infrastructure
- **Auto-scaling** to handle millions of temporary emails
- **CDN integration** for worldwide performance optimization
### **🛡️ Enterprise Security**
- **SOC 2 compliance** for enterprise-grade security
- **End-to-end encryption** for all temporary emails
- **GDPR & CCPA compliant** data handling
- **Zero data retention** after email expiration
### **💡 Developer Experience**
- **Comprehensive Python SDK** with full documentation
- **RESTful API** with intuitive endpoints
- **Webhook support** for real-time notifications
- **24/7 developer support** via [Boomlify.com](https://boomlify.com)
## 🏆 Boomlify vs Competitors - Complete Feature Comparison
### 📊 **Detailed Comparison Table**
| Feature | **Boomlify** | TempMail | Mailinator | 10MinuteMail | GuerrillaMail | YOPmail |
|---------|--------------|----------|------------|--------------|---------------|---------|
| **📅 Max Email Duration** | **2+ months** ✨ | 10 minutes | 6 hours | 10 minutes | 1 hour | 8 days |
| **📬 Smart Inbox Preview** | **✅ Exclusive** | ❌ No | ❌ No | ❌ No | ❌ No | ❌ No |
| **🏢 Custom Domains** | **✅ Full Support** | ❌ No | ✅ Limited | ❌ No | ❌ No | ❌ No |
| **📨 Gmail Integration** | **✅ 99.9% Accept** | ❌ No | ❌ No | ❌ No | ❌ No | ❌ No |
| **🔄 API Rate Limits** | **1000+/min** | 100/min | 50/min | 20/min | No API | No API |
| **🐍 Python SDK** | **✅ Complete** | ❌ No | ✅ Basic | ❌ No | ❌ No | ❌ No |
| **🔗 Webhook Support** | **✅ Advanced** | ❌ No | ❌ No | ❌ No | ❌ No | ❌ No |
| **📱 Mobile Apps** | **✅ iOS & Android** | ❌ No | ❌ No | ❌ No | ❌ No | ❌ No |
| **📧 Email Sending** | **✅ Full Support** | ❌ No | ✅ Limited | ❌ No | ✅ Basic | ❌ No |
| **🔐 End-to-End Encryption** | **✅ Military-Grade** | ❌ Basic | ❌ Basic | ❌ Basic | ❌ Basic | ❌ Basic |
| **🌍 Multi-Language** | **✅ 16+ Languages** | ✅ 5 | ❌ English | ❌ English | ✅ 9 | ✅ 8 |
| **👥 Team Features** | **✅ Enterprise** | ❌ No | ✅ Business | ❌ No | ❌ No | ❌ No |
| **📎 Attachment Support** | **✅ Full Support** | ✅ Basic | ✅ Basic | ❌ No | ✅ Basic | ✅ Basic |
| **🔄 Email Forwarding** | **✅ Automatic** | ❌ No | ❌ No | ❌ No | ❌ No | ❌ No |
| **🔒 Password Protection** | **✅ Advanced** | ❌ No | ❌ No | ❌ No | ❌ No | ❌ No |
| **📊 Usage Analytics** | **✅ Detailed** | ❌ No | ✅ Basic | ❌ No | ❌ No | ❌ No |
| **🏛️ GDPR Compliance** | **✅ Certified** | ❌ No | ✅ Basic | ❌ No | ❌ No | ❌ No |
| **🎯 Custom Email Format** | **✅ Premium** | ❌ No | ❌ No | ❌ No | ❌ No | ❌ No |
| **💻 CLI Tools** | **✅ Advanced** | ❌ No | ❌ No | ❌ No | ❌ No | ❌ No |
| **🔄 Real-time Updates** | **✅ WebSocket** | ❌ Manual | ❌ Manual | ❌ Manual | ❌ Manual | ❌ Manual |
| **🎭 White-Label Options** | **✅ Available** | ❌ No | ❌ No | ❌ No | ❌ No | ❌ No |
| **🆘 Support Quality** | **✅ 24/7 Expert** | ❌ Limited | ✅ Business | ❌ None | ❌ Community | ❌ None |
| **💰 Pricing Model** | **✅ Flexible** | Free/Ads | Free/Premium | Free Only | Free/Premium | Free/Ads |
### 🎯 **Why Developers Choose Boomlify Over Competitors**
#### **🚀 Performance Advantages**
- **200ms response times** vs competitors' 1-5 second delays
- **Global CDN** vs single-region servers
- **99.9% uptime** vs 95-98% industry average
- **Auto-scaling** vs fixed capacity limitations
#### **🛡️ Security Leadership**
- **SOC 2 Type II certified** vs no certifications
- **End-to-end encryption** vs basic SSL only
- **Zero-knowledge architecture** vs data access capabilities
- **Advanced threat protection** vs basic spam filtering
#### **💼 Enterprise Features**
- **Team management dashboard** vs individual accounts only
- **Custom domain integration** vs generic domains only
- **API rate limits 10x higher** than closest competitor
- **Professional support** vs community forums
#### **🌍 Global Reach**
- **16+ languages** vs English-only or limited translations
- **Worldwide servers** vs regional limitations
- **Local compliance** vs one-size-fits-all approach
- **Cultural customization** vs generic interfaces
**Start with [Boomlify](https://boomlify.com) today** and experience the revolutionary difference!
---
## 🌟 **Comprehensive Boomlify Service Overview**
### 🎯 **Revolutionary Smart Inbox Preview Technology**
[Boomlify's Smart Inbox Preview](https://boomlify.com/features) is the **only temporary email service** that displays messages from ALL your [disposable email addresses](https://boomlify.com) on a single unified dashboard. No more tab switching or manual refreshing!
```
┌─────────────────────────────────────────────────────────────┐
│ 📧 UNIFIED TEMP MAIL DASHBOARD │
├─────────────────────────────────────────────────────────────┤
│ 📮 test@boomlify.com │ 📬 New: Welcome Email │
│ 📮 temp@secure-mail.biz │ 📬 New: Verification Code │
│ 📮 trial@disposable.me │ 📬 New: Newsletter Signup │
│ 📮 business@yourdomain.com│ 📬 New: Account Activation │
│ 📮 gmail-temp@gmail.com │ 📬 New: Payment Confirmation │
├─────────────────────────────────────────────────────────────┤
│ 🔄 Real-time • 🔒 Private • ⏰ 2+ months • 🌐 16+ languages │
└─────────────────────────────────────────────────────────────┘
```
### 📧 **Complete Temporary Email Use Cases**
[Boomlify temporary email service](https://boomlify.com) excels in every scenario:
#### 🧪 **Testing & Development**
- **Email verification testing**: Test signup flows with [disposable emails](https://boomlify.com)
- **API integration testing**: Validate email notifications in applications
- **Load testing**: Generate bulk [temporary emails](https://boomlify.com) for performance testing
- **Webhook testing**: Receive email notifications for webhook validation
- **CI/CD integration**: Automated testing with unique email addresses
- **A/B testing**: Multiple [temp emails](https://boomlify.com) for campaign testing
- **Bug tracking**: Isolate issues with dedicated test emails
- **Demo environments**: Clean email addresses for demonstrations
#### 🔒 **Privacy & Security Protection**
- **Anonymous registrations**: Sign up without revealing real email
- **Spam prevention**: Protect main inbox from unwanted messages
- **Data breach protection**: Isolate sensitive communications
- **Identity shielding**: Hide personal information during transactions
- **Marketing avoidance**: Bypass promotional email lists
- **Phishing protection**: Use [throwaway emails](https://boomlify.com) for suspicious sites
- **Social media privacy**: Create accounts without email exposure
- **Online shopping**: Protect personal email during purchases
#### 🏢 **Business & Enterprise Applications**
- **Customer onboarding**: Streamline registration processes
- **Vendor communications**: Temporary channels for supplier interactions
- **Event management**: Time-limited emails for registrations
- **Customer support**: Protect team emails from external exposure
- **Lead generation**: Capture prospects without permanent commitments
- **Partnership outreach**: Professional temporary communication channels
- **Compliance testing**: Validate email workflows for regulations
- **Employee training**: Safe email addresses for training scenarios
#### 🎓 **Educational & Research**
- **Course registrations**: [Temporary email addresses](https://boomlify.com) for online courses
- **Research participation**: Anonymous email for studies
- **Academic trials**: Access educational resources without commitment
- **Student projects**: Clean email addresses for assignments
- **Conference registration**: Event-specific temporary emails
- **Webinar attendance**: One-time registration addresses
- **Survey participation**: Anonymous feedback collection
- **Beta testing**: Educational software evaluation
### 🌐 **Global Temporary Email Infrastructure**
#### 🚀 **Performance Metrics**
- **⚡ Sub-200ms response times** worldwide
- **🌍 99.9% global uptime** guarantee
- **🔄 Auto-scaling to millions** of concurrent users
- **📡 CDN-powered delivery** for instant access
- **🏎️ Real-time WebSocket** notifications
- **⚖️ Intelligent load balancing** across continents
#### 🔐 **Security Standards**
- **🛡️ SOC 2 Type II certified** enterprise security
- **🔒 End-to-end encryption** for all communications
- **🆔 Zero-knowledge architecture** ensuring privacy
- **📋 GDPR & CCPA compliant** data handling
- **🔐 Advanced threat protection** against malicious content
- **🛡️ Multi-factor authentication** for account security
### 📱 **Multi-Platform Temporary Email Access**
#### 🌟 **Available Everywhere**
- **💻 Web Application**: Full-featured [temporary email dashboard](https://boomlify.com)
- **📱 iOS App**: Native iPhone and iPad [temp mail](https://boomlify.com) experience
- **🤖 Android App**: Complete Android [disposable email](https://boomlify.com) solution
- **🌐 Progressive Web App**: App-like experience in any browser
- **💻 Desktop Apps**: Windows, macOS, and Linux applications
- **⌨️ CLI Tools**: Command-line interface for developers
- **🔗 Browser Extensions**: Chrome, Firefox, Safari, and Edge plugins
#### 🔄 **Cross-Platform Synchronization**
- **📱 Real-time sync** across all devices
- **☁️ Cloud backup** of temporary email data
- **🔄 Automatic updates** when emails arrive
- **📊 Unified analytics** across all platforms
- **🎯 Consistent experience** regardless of access method
## 📈 Getting Started with Boomlify
1. **Sign up** at [Boomlify.com](https://boomlify.com) for your free account
2. **Get your API key** from the dashboard
3. **Install** the Python package: `pip install boomlify`
4. **Start creating** temporary emails in minutes!
## 🔗 Useful Links
- 🌐 **Official Website**: [Boomlify.com](https://boomlify.com)
- 📚 **API Documentation**: [Boomlify.com/docs](https://boomlify.com/docs)
- 🎮 **Interactive Demo**: [Boomlify.com/demo](https://boomlify.com/demo)
- 💬 **Community Support**: [Boomlify.com/community](https://boomlify.com/community)
- 📧 **Email Support**: support@boomlify.com
- 🐛 **Bug Reports**: [GitHub Issues](https://github.com/boomlify/boomlify-python/issues)
## Contributing
We welcome contributions! Please feel free to submit a Pull Request.
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
---
**[Boomlify](https://boomlify.com) - The Ultimate Temporary Email Solution**
*Create temporary emails instantly | Disposable email API | Temp mail service | Email testing tools*
© 2024 Boomlify. All rights reserved. | [Privacy Policy](https://boomlify.com/privacy) | [Terms of Service](https://boomlify.com/terms)
Raw data
{
"_id": null,
"home_page": "https://github.com/boomlify/boomlify-python",
"name": "boomlify",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": "Boomlify <support@boomlify.com>",
"keywords": "email, temporary, temp, mail, api, boomlify, disposable, testing, automation",
"author": "Boomlify",
"author_email": "Boomlify <support@boomlify.com>",
"download_url": "https://files.pythonhosted.org/packages/d3/ed/d86e70134de120d1e1767523fc10190e523ef2eea1eab72de597b52fd0e9/boomlify-1.0.1.tar.gz",
"platform": null,
"description": "# Boomlify - Best Temporary Email API for Python | Disposable Email Service\r\n\r\n[](https://badge.fury.io/py/boomlify)\r\n[](https://pypi.org/project/boomlify/)\r\n[](https://opensource.org/licenses/MIT)\r\n[](https://boomlify.com)\r\n\r\n<!-- \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\r\nSEO Anchor Diversity \u2013 multiple keyword variations pointing to Boomlify\r\n\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500 -->\r\n[temporary email service](https://boomlify.com) \u2022 [disposable email API](https://boomlify.com) \u2022 [temp mail generator](https://boomlify.com) \u2022 [throwaway email toolbox](https://boomlify.com)\r\n\r\n**[Boomlify](https://boomlify.com)** is the world's most advanced temporary email service, disposable email **API**, *temp-mail* generator and privacy-first **throw-away email platform** for developers. This Python client library provides seamless integration with the Boomlify temporary email API, making it easy to create, manage, and monitor temporary emails for testing, automation, and development purposes.\r\n\r\n## \ud83d\ude80 Why Choose Boomlify Temporary Email Service?\r\n\r\n[Boomlify](https://boomlify.com) stands out as the premier temporary email solution with:\r\n\r\n- **\ud83d\udd25 Long-lasting emails** - Unlike other temp mail services, Boomlify emails last up to 24 hours\r\n- **\u26a1 Lightning-fast API** - Industry-leading response times for temporary email operations \r\n- **\ud83c\udf10 Custom domains** - Use your own domains with our temporary email service\r\n- **\ud83d\udee1\ufe0f Enterprise security** - Advanced protection for your temporary email needs\r\n- **\ud83d\udcca Analytics dashboard** - Comprehensive insights into your temporary email usage\r\n- **\ud83d\udd04 Auto-rotation** - Intelligent load balancing across multiple servers\r\n\r\nVisit [Boomlify.com](https://boomlify.com) to get started with the best temporary email service available.\r\n\r\n## \ud83c\udfaf Complete Boomlify Temporary Email API Features\r\n\r\n[Boomlify](https://boomlify.com) offers the world's most comprehensive [temporary email API](https://boomlify.com/api) with revolutionary features:\r\n\r\n### \ud83d\ude80 **Core Temporary Email Features**\r\n- \ud83d\udce7 **Instant email generation**: Create [disposable email addresses](https://boomlify.com) in seconds\r\n- \u23f0 **Extended validity**: Industry-leading **2+ months** vs competitors' 10-60 minutes\r\n- \ud83d\udcec **Smart Inbox Preview**: Monitor multiple [temp emails](https://boomlify.com) simultaneously (EXCLUSIVE)\r\n- \ud83d\udd04 **Unlimited addresses**: Generate unlimited [throwaway emails](https://boomlify.com) with no restrictions\r\n- \ud83d\udce8 **Email sending & receiving**: Full bidirectional communication from [temporary addresses](https://boomlify.com)\r\n- \ud83d\udce5 **Email forwarding**: Auto-route messages to your permanent inbox\r\n- \ud83d\uddc2\ufe0f **Message threading**: Organized conversation views for better management\r\n- \ud83d\udcce **Attachment support**: Receive and view file attachments seamlessly\r\n- \ud83d\udd04 **Auto-refresh**: Real-time inbox updates without manual checking\r\n\r\n### \ud83c\udf10 **Domain & Deliverability Excellence**\r\n- \ud83c\udff7\ufe0f **Custom domain support**: Use your own domains for professional [temp mail](https://boomlify.com)\r\n- \ud83d\udce8 **Gmail-based temporary emails**: 99.9% acceptance rate using Gmail infrastructure\r\n- \ud83c\udf0d **Multiple premium domains**: High-acceptance domains that bypass spam filters\r\n- \ud83d\udd12 **SSL/TLS encryption**: Secure custom domain email transmission\r\n- \ud83c\udfe2 **Subdomain flexibility**: Department-specific email addresses for enterprises\r\n- \ud83d\udcca **Domain analytics**: Track performance metrics for each domain\r\n\r\n### \ud83d\udd10 **Enterprise Security & Privacy**\r\n- \ud83d\udee1\ufe0f **End-to-end encryption**: Military-grade protection for all communications\r\n- \ud83d\udd10 **Zero-knowledge architecture**: Complete privacy with no data access\r\n- \ud83c\udd94 **Password protection**: Secure access controls for sensitive emails\r\n- \ud83d\udd12 **Multi-factor authentication**: Enhanced account security for enterprises\r\n- \ud83d\udccb **GDPR compliance**: European data protection standards\r\n- \ud83c\udfdb\ufe0f **SOC 2 Type II certified**: Enterprise-grade security assurance\r\n- \u26a1 **Advanced threat protection**: Malicious content detection and blocking\r\n- \ud83d\udee1\ufe0f **Secure attachment handling**: Virus scanning and safe file processing\r\n\r\n### \ud83c\udf0d **Global Infrastructure & Performance**\r\n- \ud83d\ude80 **Sub-200ms response times**: Lightning-fast API responses worldwide\r\n- \ud83c\udf10 **Global server network**: Optimized performance across all continents\r\n- \u26a1 **99.9% uptime guarantee**: Enterprise-grade reliability and availability\r\n- \ud83d\udd04 **Auto-scaling infrastructure**: Handle millions of requests seamlessly\r\n- \ud83d\udce1 **CDN integration**: Worldwide content delivery optimization\r\n- \ud83c\udfce\ufe0f **Real-time WebSocket updates**: Instant email notifications\r\n\r\n### \ud83d\udcbb **Developer-First API Experience**\r\n- \ud83e\udde9 **RESTful & GraphQL APIs**: Choose your preferred API architecture\r\n- \ud83d\udcda **Comprehensive SDKs**: Official libraries for **Python**, **Node.js**, **Go**, **PHP**, **Java**\r\n- \ud83d\udd27 **CLI tools**: Command-line interface for automation and scripts\r\n- \ud83d\udd17 **Webhook support**: Real-time HTTP callbacks for new emails\r\n- \ud83d\udd10 **OAuth2 integration**: Enterprise SSO and fine-grained API tokens\r\n- \ud83d\udcca **Rate limiting**: 1000+ requests per minute for high-volume usage\r\n- \ud83d\udcdd **Detailed documentation**: Complete guides and interactive examples\r\n\r\n### \ud83c\udfe2 **Enterprise & Team Features**\r\n- \ud83d\udc65 **Team management**: Centralized administration for business teams\r\n- \ud83d\udcca **Usage analytics**: Detailed insights into email patterns and consumption\r\n- \ud83d\udd0d **Activity logging**: Complete audit trails for compliance\r\n- \ud83d\udc64 **Role-based access**: Different permission levels for team members\r\n- \ud83d\udce7 **Shared email pools**: Team-wide temporary email address sharing\r\n- \ud83c\udff7\ufe0f **Assignment system**: Delegate specific emails to team members\r\n- \ud83d\udcbc **White-label solutions**: Fully branded temporary email experience\r\n\r\n### \ud83d\udcf1 **Multi-Platform Access**\r\n- \ud83d\udcf1 **Native mobile apps**: iOS and Android applications with full feature parity\r\n- \ud83c\udf10 **Progressive Web App**: Native app experience in browsers\r\n- \ud83d\udcbb **Cross-device sync**: Access emails from any device with account\r\n- \ud83d\udd04 **Real-time synchronization**: Instant updates across all platforms\r\n- \ud83d\udcf2 **Mobile-first design**: Optimized interface for on-the-go usage\r\n- \ud83c\udf19 **Dark/light themes**: Customizable interface preferences\r\n\r\n### \ud83c\udf0d **Global Localization**\r\n- \ud83d\udde3\ufe0f **16+ language support**: Multi-language interface and documentation\r\n- \ud83c\udf10 **Regional optimization**: Localized servers for optimal performance\r\n- \ud83d\udce7 **Internationalized domains**: Country-specific temporary email domains\r\n- \ud83d\udd52 **Timezone support**: Local time display and scheduling\r\n- \ud83d\udcf1 **Localized mobile apps**: Native language support on all platforms\r\n\r\n### \ud83d\udd27 **Advanced Customization**\r\n- \ud83d\udcc6 **Custom TTL**: Set any lifetime from 60 seconds to **2+ months**\r\n- \ud83c\udff7\ufe0f **Tagged addresses**: Add `+labels` for campaign tracking and organization\r\n- \ud83d\udce5 **Bulk email generation**: Create hundreds of temp emails for load testing\r\n- \ud83c\udfa8 **Custom email formats**: Personalized address formats for premium users\r\n- \ud83d\udce7 **Email aliases**: Multiple addresses routing to single inbox\r\n- \ud83e\udd16 **Auto-replies**: Automated responses for temporary addresses\r\n- \ud83d\udccb **Email filtering**: Advanced rules for sorting and organizing messages\r\n\r\n### \ud83d\udcca **Data Management & Export**\r\n- \ud83d\udcd1 **JSON & CSV export**: Download inbox contents for reports and analysis\r\n- \ud83d\udcbe **Data retention controls**: Flexible storage policies for compliance\r\n- \ud83d\uddc4\ufe0f **Archive functionality**: Long-term storage for important messages\r\n- \ud83d\udcc8 **Analytics dashboard**: Usage patterns and performance metrics\r\n- \ud83d\udd0d **Search capabilities**: Advanced filtering and search across all emails\r\n- \ud83d\udcca **Reporting tools**: Generate detailed usage and activity reports\r\n\r\n### \ud83d\ude80 **Performance & Reliability**\r\n- \u26a1 **High-speed email delivery**: Instant message routing and processing\r\n- \ud83d\udd04 **Automatic failover**: Redundant systems ensure continuous service\r\n- \ud83d\udcc8 **Load balancing**: Intelligent traffic distribution for optimal performance\r\n- \ud83d\udee0\ufe0f **Auto-retry mechanisms**: Built-in retry logic for failed operations\r\n- \ud83d\udcca **Real-time monitoring**: 24/7 system health and performance tracking\r\n- \ud83d\udea8 **Proactive alerts**: Instant notifications for any service issues\r\n\r\n### \ud83c\udfaf **Specialized Use Cases**\r\n- \ud83e\uddea **Testing & QA**: Automated testing with unique email addresses\r\n- \ud83d\udd12 **Privacy protection**: Shield real email from spam and tracking\r\n- \ud83d\udce7 **Email verification**: Reliable verification code reception\r\n- \ud83c\udfe2 **Business communications**: Professional temporary channels\r\n- \ud83d\udcf1 **App development**: Integration testing for email notifications\r\n- \ud83c\udfaf **Marketing campaigns**: A/B testing with different email addresses\r\n- \ud83c\udf93 **Educational use**: Temporary emails for course registrations\r\n- \ud83d\udecd\ufe0f **E-commerce testing**: Order confirmations and shipping notifications\r\n\r\n## \ud83d\udce6 Installation - Get Started with Boomlify Temporary Email\r\n\r\nInstall the best temporary email Python package using pip:\r\n\r\n```bash\r\npip install boomlify\r\n```\r\n\r\nGet your FREE API key at [Boomlify.com](https://boomlify.com) to start using our temporary email service.\r\n\r\n## \ud83d\ude80 Quick Start - Create Your First Temporary Email\r\n\r\nStart using [Boomlify's temporary email API](https://boomlify.com) in just a few lines of code:\r\n\r\n```python\r\nfrom boomlify import BoomlifyClient\r\n\r\n# Initialize the client\r\nclient = BoomlifyClient(api_key=\"your_api_key_here\")\r\n\r\n# Create a temporary email\r\nemail = client.create_email(time_option=\"10min\")\r\nprint(f\"Created email: {email.address}\")\r\nprint(f\"Email ID: {email.id}\")\r\nprint(f\"Expires at: {email.expires_at}\")\r\n\r\n# List your emails\r\nemails = client.list_emails()\r\nprint(f\"You have {emails.total_count} emails\")\r\nfor email in emails.emails:\r\n print(f\"- {email.address} (ID: {email.id})\")\r\n\r\n# Get messages for an email\r\nmessages = client.get_messages(email.id)\r\nprint(f\"Found {len(messages.messages)} messages\")\r\nfor message in messages.messages:\r\n print(f\"From: {message.from_address}\")\r\n print(f\"Subject: {message.subject}\")\r\n print(f\"Body: {message.body}\")\r\n\r\n# Wait for new emails (polling)\r\nprint(\"Waiting for new emails...\")\r\nnew_message = client.wait_for_mail(email.id, timeout_seconds=60)\r\nif new_message:\r\n print(f\"New message: {new_message.subject}\")\r\nelse:\r\n print(\"No new messages received\")\r\n\r\n# Get account information\r\naccount = client.get_account()\r\nprint(f\"Plan: {account.plan}\")\r\nprint(f\"Daily limit: {account.daily_limit}\")\r\nprint(f\"Remaining emails: {account.remaining_emails}\")\r\n\r\n# Delete an email\r\nclient.delete_email(email.id)\r\nprint(\"Email deleted\")\r\n```\r\n\r\n## API Reference\r\n\r\n### BoomlifyClient\r\n\r\nThe main client class for interacting with the Boomlify API.\r\n\r\n#### Constructor\r\n\r\n```python\r\nBoomlifyClient(api_key, base_url=None, timeout=30, max_retries=3)\r\n```\r\n\r\n- `api_key` (str): Your Boomlify API key\r\n- `base_url` (str, optional): API base URL (auto-fetched if not provided)\r\n- `timeout` (int): Request timeout in seconds (default: 30)\r\n- `max_retries` (int): Maximum retries for failed requests (default: 3)\r\n\r\n#### Methods\r\n\r\n##### create_email(time_option=\"10min\", custom_domain=None)\r\n\r\nCreate a new temporary email address.\r\n\r\n```python\r\nemail = client.create_email(time_option=\"1hour\", custom_domain=\"yourdomain.com\")\r\n```\r\n\r\n**Parameters:**\r\n- `time_option` (str): Email lifespan - \"10min\", \"1hour\", or \"1day\"\r\n- `custom_domain` (str, optional): Custom domain (must be verified)\r\n\r\n**Returns:** `Email` object\r\n\r\n##### list_emails(include_expired=False, limit=10)\r\n\r\nList your temporary emails.\r\n\r\n```python\r\nemails = client.list_emails(include_expired=True, limit=20)\r\n```\r\n\r\n**Parameters:**\r\n- `include_expired` (bool): Include expired emails (default: False)\r\n- `limit` (int): Maximum number of emails to return (default: 10)\r\n\r\n**Returns:** `EmailList` object\r\n\r\n##### get_email(email_id)\r\n\r\nGet details of a specific email.\r\n\r\n```python\r\nemail = client.get_email(\"email_id_here\")\r\n```\r\n\r\n**Parameters:**\r\n- `email_id` (str): The email ID\r\n\r\n**Returns:** `Email` object\r\n\r\n##### get_messages(email_id, limit=10, offset=0)\r\n\r\nGet messages for a specific email.\r\n\r\n```python\r\nmessages = client.get_messages(\"email_id_here\", limit=5, offset=0)\r\n```\r\n\r\n**Parameters:**\r\n- `email_id` (str): The email ID\r\n- `limit` (int): Maximum number of messages to return (default: 10)\r\n- `offset` (int): Number of messages to skip (default: 0)\r\n\r\n**Returns:** `MessageList` object\r\n\r\n##### delete_email(email_id)\r\n\r\nDelete a temporary email.\r\n\r\n```python\r\nsuccess = client.delete_email(\"email_id_here\")\r\n```\r\n\r\n**Parameters:**\r\n- `email_id` (str): The email ID to delete\r\n\r\n**Returns:** `bool` - True if deletion was successful\r\n\r\n##### get_usage()\r\n\r\nGet usage statistics for your account.\r\n\r\n```python\r\nusage = client.get_usage()\r\nprint(f\"Total emails created: {usage.total_emails_created}\")\r\nprint(f\"Messages today: {usage.messages_today}\")\r\n```\r\n\r\n**Returns:** `UsageInfo` object\r\n\r\n##### get_account()\r\n\r\nGet account information.\r\n\r\n```python\r\naccount = client.get_account()\r\nprint(f\"Plan: {account.plan}\")\r\nprint(f\"Daily limit: {account.daily_limit}\")\r\n```\r\n\r\n**Returns:** `AccountInfo` object\r\n\r\n##### wait_for_mail(email_id, timeout_seconds=300, check_interval=5)\r\n\r\nWait for new emails to arrive.\r\n\r\n```python\r\nmessage = client.wait_for_mail(\"email_id_here\", timeout_seconds=60, check_interval=3)\r\nif message:\r\n print(f\"New message: {message.subject}\")\r\n```\r\n\r\n**Parameters:**\r\n- `email_id` (str): The email ID to monitor\r\n- `timeout_seconds` (int): Maximum time to wait in seconds (default: 300)\r\n- `check_interval` (int): How often to check for new messages in seconds (default: 5)\r\n\r\n**Returns:** `EmailMessage` if new message arrives, `None` if timeout\r\n\r\n##### get_base_url()\r\n\r\nGet the current API base URL.\r\n\r\n```python\r\nbase_url = client.get_base_url()\r\n```\r\n\r\n**Returns:** `str` - The current API base URL\r\n\r\n##### refresh_base_url()\r\n\r\nForce refresh of the base URL.\r\n\r\n```python\r\nnew_base_url = client.refresh_base_url()\r\n```\r\n\r\n**Returns:** `str` - The new base URL\r\n\r\n## Data Models\r\n\r\n### Email\r\n\r\nRepresents a temporary email address.\r\n\r\n```python\r\n@dataclass\r\nclass Email:\r\n id: str\r\n address: str\r\n domain: str\r\n time_tier: str\r\n expires_at: str\r\n is_expired: bool\r\n message_count: int\r\n time_remaining_minutes: int\r\n```\r\n\r\n### EmailMessage\r\n\r\nRepresents an email message.\r\n\r\n```python\r\n@dataclass\r\nclass EmailMessage:\r\n id: str\r\n subject: str\r\n body: str\r\n from_address: str\r\n to_address: str\r\n received_at: str\r\n attachments: List[Dict[str, Any]]\r\n headers: Dict[str, str]\r\n```\r\n\r\n### EmailList\r\n\r\nRepresents a list of emails with metadata.\r\n\r\n```python\r\n@dataclass\r\nclass EmailList:\r\n emails: List[Email]\r\n total_count: int\r\n success: bool\r\n message: str\r\n```\r\n\r\n### MessageList\r\n\r\nRepresents a list of messages with metadata.\r\n\r\n```python\r\n@dataclass\r\nclass MessageList:\r\n messages: List[EmailMessage]\r\n total_messages: int\r\n first_message_subject: Optional[str]\r\n first_message_body: Optional[str]\r\n first_message_from: Optional[str]\r\n success: bool\r\n message: str\r\n```\r\n\r\n## Error Handling\r\n\r\nThe client provides comprehensive error handling with custom exceptions:\r\n\r\n```python\r\nfrom boomlify import BoomlifyClient, BoomlifyError, BoomlifyAuthError, BoomlifyRateLimitError\r\n\r\nclient = BoomlifyClient(api_key=\"your_api_key\")\r\n\r\ntry:\r\n email = client.create_email()\r\nexcept BoomlifyAuthError as e:\r\n print(f\"Authentication error: {e}\")\r\nexcept BoomlifyRateLimitError as e:\r\n print(f\"Rate limit exceeded. Retry after {e.retry_after} seconds\")\r\nexcept BoomlifyError as e:\r\n print(f\"General error: {e}\")\r\n```\r\n\r\n### Exception Types\r\n\r\n- `BoomlifyError`: Base exception for all errors\r\n- `BoomlifyAPIError`: API returned an error response\r\n- `BoomlifyAuthError`: Authentication errors (401, 403)\r\n- `BoomlifyNotFoundError`: Resource not found (404)\r\n- `BoomlifyRateLimitError`: Rate limit exceeded (429)\r\n- `BoomlifyTimeoutError`: Request timeout\r\n- `BoomlifyValidationError`: Client-side validation errors\r\n\r\n## Context Manager Support\r\n\r\nThe client supports context manager usage for automatic resource cleanup:\r\n\r\n```python\r\nwith BoomlifyClient(api_key=\"your_api_key\") as client:\r\n email = client.create_email()\r\n messages = client.get_messages(email.id)\r\n # Session is automatically closed when exiting the context\r\n```\r\n\r\n## Advanced Usage\r\n\r\n### Custom Domains\r\n\r\nIf you have verified custom domains in your Boomlify account:\r\n\r\n```python\r\n# Create email with custom domain\r\nemail = client.create_email(time_option=\"1hour\", custom_domain=\"yourdomain.com\")\r\nprint(f\"Created email: {email.address}\") # user@yourdomain.com\r\n```\r\n\r\n### Batch Operations\r\n\r\n```python\r\n# Create multiple emails\r\nemails = []\r\nfor i in range(3):\r\n email = client.create_email(time_option=\"10min\")\r\n emails.append(email)\r\n print(f\"Created: {email.address}\")\r\n\r\n# Monitor all emails for messages\r\nfor email in emails:\r\n messages = client.get_messages(email.id)\r\n if messages.messages:\r\n print(f\"Email {email.address} has {len(messages.messages)} messages\")\r\n```\r\n\r\n### Polling for Messages\r\n\r\n```python\r\nimport time\r\n\r\ndef monitor_email(client, email_id, duration=300):\r\n \"\"\"Monitor an email for new messages.\"\"\"\r\n end_time = time.time() + duration\r\n \r\n while time.time() < end_time:\r\n messages = client.get_messages(email_id)\r\n if messages.messages:\r\n for message in messages.messages:\r\n print(f\"New message from {message.from_address}: {message.subject}\")\r\n \r\n time.sleep(10) # Check every 10 seconds\r\n\r\n# Usage\r\nemail = client.create_email()\r\nmonitor_email(client, email.id, duration=120)\r\n```\r\n\r\n## Rate Limiting\r\n\r\nThe client automatically handles rate limiting with exponential backoff. When you hit rate limits, the client will:\r\n\r\n1. Catch the `BoomlifyRateLimitError`\r\n2. Automatically retry after the specified delay\r\n3. Use exponential backoff for subsequent retries\r\n\r\n## \ud83c\udfaf Temporary Email Use Cases\r\n\r\n[Boomlify's temporary email service](https://boomlify.com) is perfect for:\r\n\r\n### \ud83e\uddea **Testing & QA**\r\n- **Email verification testing** - Test signup flows with disposable emails\r\n- **API testing** - Validate email notifications in your applications\r\n- **Automation testing** - Create temporary emails for test scenarios\r\n- **Load testing** - Generate multiple temporary emails for performance testing\r\n\r\n### \ud83d\udd12 **Privacy & Security**\r\n- **Anonymous registrations** - Sign up for services without revealing your real email\r\n- **Temporary communications** - Receive emails without spam concerns\r\n- **Data protection** - Keep your personal email address private\r\n- **GDPR compliance** - Use temporary emails for data processing\r\n\r\n### \ud83d\udee0\ufe0f **Development & Integration**\r\n- **API integrations** - Test email functionality during development\r\n- **Webhook testing** - Receive email notifications for webhook testing\r\n- **Demo accounts** - Create temporary accounts for demonstrations\r\n- **Beta testing** - Provide temporary emails for beta user testing\r\n\r\n### \ud83c\udfe2 **Business Applications**\r\n- **Customer onboarding** - Streamline registration processes\r\n- **Email marketing** - Test email campaigns before sending\r\n- **Customer support** - Create temporary channels for support tickets\r\n- **Lead generation** - Capture leads without permanent email commitments\r\n\r\n## \ud83c\udf1f Why Developers Choose Boomlify\r\n\r\n### **\ud83d\ude80 Performance Leader**\r\n[Boomlify](https://boomlify.com) offers the fastest temporary email API in the industry with:\r\n- **Sub-second response times** for email creation\r\n- **99.9% uptime** guarantee with global infrastructure\r\n- **Auto-scaling** to handle millions of temporary emails\r\n- **CDN integration** for worldwide performance optimization\r\n\r\n### **\ud83d\udee1\ufe0f Enterprise Security**\r\n- **SOC 2 compliance** for enterprise-grade security\r\n- **End-to-end encryption** for all temporary emails\r\n- **GDPR & CCPA compliant** data handling\r\n- **Zero data retention** after email expiration\r\n\r\n### **\ud83d\udca1 Developer Experience**\r\n- **Comprehensive Python SDK** with full documentation\r\n- **RESTful API** with intuitive endpoints\r\n- **Webhook support** for real-time notifications\r\n- **24/7 developer support** via [Boomlify.com](https://boomlify.com)\r\n\r\n## \ud83c\udfc6 Boomlify vs Competitors - Complete Feature Comparison\r\n\r\n### \ud83d\udcca **Detailed Comparison Table**\r\n\r\n| Feature | **Boomlify** | TempMail | Mailinator | 10MinuteMail | GuerrillaMail | YOPmail |\r\n|---------|--------------|----------|------------|--------------|---------------|---------|\r\n| **\ud83d\udcc5 Max Email Duration** | **2+ months** \u2728 | 10 minutes | 6 hours | 10 minutes | 1 hour | 8 days |\r\n| **\ud83d\udcec Smart Inbox Preview** | **\u2705 Exclusive** | \u274c No | \u274c No | \u274c No | \u274c No | \u274c No |\r\n| **\ud83c\udfe2 Custom Domains** | **\u2705 Full Support** | \u274c No | \u2705 Limited | \u274c No | \u274c No | \u274c No |\r\n| **\ud83d\udce8 Gmail Integration** | **\u2705 99.9% Accept** | \u274c No | \u274c No | \u274c No | \u274c No | \u274c No |\r\n| **\ud83d\udd04 API Rate Limits** | **1000+/min** | 100/min | 50/min | 20/min | No API | No API |\r\n| **\ud83d\udc0d Python SDK** | **\u2705 Complete** | \u274c No | \u2705 Basic | \u274c No | \u274c No | \u274c No |\r\n| **\ud83d\udd17 Webhook Support** | **\u2705 Advanced** | \u274c No | \u274c No | \u274c No | \u274c No | \u274c No |\r\n| **\ud83d\udcf1 Mobile Apps** | **\u2705 iOS & Android** | \u274c No | \u274c No | \u274c No | \u274c No | \u274c No |\r\n| **\ud83d\udce7 Email Sending** | **\u2705 Full Support** | \u274c No | \u2705 Limited | \u274c No | \u2705 Basic | \u274c No |\r\n| **\ud83d\udd10 End-to-End Encryption** | **\u2705 Military-Grade** | \u274c Basic | \u274c Basic | \u274c Basic | \u274c Basic | \u274c Basic |\r\n| **\ud83c\udf0d Multi-Language** | **\u2705 16+ Languages** | \u2705 5 | \u274c English | \u274c English | \u2705 9 | \u2705 8 |\r\n| **\ud83d\udc65 Team Features** | **\u2705 Enterprise** | \u274c No | \u2705 Business | \u274c No | \u274c No | \u274c No |\r\n| **\ud83d\udcce Attachment Support** | **\u2705 Full Support** | \u2705 Basic | \u2705 Basic | \u274c No | \u2705 Basic | \u2705 Basic |\r\n| **\ud83d\udd04 Email Forwarding** | **\u2705 Automatic** | \u274c No | \u274c No | \u274c No | \u274c No | \u274c No |\r\n| **\ud83d\udd12 Password Protection** | **\u2705 Advanced** | \u274c No | \u274c No | \u274c No | \u274c No | \u274c No |\r\n| **\ud83d\udcca Usage Analytics** | **\u2705 Detailed** | \u274c No | \u2705 Basic | \u274c No | \u274c No | \u274c No |\r\n| **\ud83c\udfdb\ufe0f GDPR Compliance** | **\u2705 Certified** | \u274c No | \u2705 Basic | \u274c No | \u274c No | \u274c No |\r\n| **\ud83c\udfaf Custom Email Format** | **\u2705 Premium** | \u274c No | \u274c No | \u274c No | \u274c No | \u274c No |\r\n| **\ud83d\udcbb CLI Tools** | **\u2705 Advanced** | \u274c No | \u274c No | \u274c No | \u274c No | \u274c No |\r\n| **\ud83d\udd04 Real-time Updates** | **\u2705 WebSocket** | \u274c Manual | \u274c Manual | \u274c Manual | \u274c Manual | \u274c Manual |\r\n| **\ud83c\udfad White-Label Options** | **\u2705 Available** | \u274c No | \u274c No | \u274c No | \u274c No | \u274c No |\r\n| **\ud83c\udd98 Support Quality** | **\u2705 24/7 Expert** | \u274c Limited | \u2705 Business | \u274c None | \u274c Community | \u274c None |\r\n| **\ud83d\udcb0 Pricing Model** | **\u2705 Flexible** | Free/Ads | Free/Premium | Free Only | Free/Premium | Free/Ads |\r\n\r\n### \ud83c\udfaf **Why Developers Choose Boomlify Over Competitors**\r\n\r\n#### **\ud83d\ude80 Performance Advantages**\r\n- **200ms response times** vs competitors' 1-5 second delays\r\n- **Global CDN** vs single-region servers\r\n- **99.9% uptime** vs 95-98% industry average\r\n- **Auto-scaling** vs fixed capacity limitations\r\n\r\n#### **\ud83d\udee1\ufe0f Security Leadership**\r\n- **SOC 2 Type II certified** vs no certifications\r\n- **End-to-end encryption** vs basic SSL only\r\n- **Zero-knowledge architecture** vs data access capabilities\r\n- **Advanced threat protection** vs basic spam filtering\r\n\r\n#### **\ud83d\udcbc Enterprise Features**\r\n- **Team management dashboard** vs individual accounts only\r\n- **Custom domain integration** vs generic domains only\r\n- **API rate limits 10x higher** than closest competitor\r\n- **Professional support** vs community forums\r\n\r\n#### **\ud83c\udf0d Global Reach**\r\n- **16+ languages** vs English-only or limited translations\r\n- **Worldwide servers** vs regional limitations\r\n- **Local compliance** vs one-size-fits-all approach\r\n- **Cultural customization** vs generic interfaces\r\n\r\n**Start with [Boomlify](https://boomlify.com) today** and experience the revolutionary difference!\r\n\r\n---\r\n\r\n## \ud83c\udf1f **Comprehensive Boomlify Service Overview**\r\n\r\n### \ud83c\udfaf **Revolutionary Smart Inbox Preview Technology**\r\n[Boomlify's Smart Inbox Preview](https://boomlify.com/features) is the **only temporary email service** that displays messages from ALL your [disposable email addresses](https://boomlify.com) on a single unified dashboard. No more tab switching or manual refreshing!\r\n\r\n```\r\n\u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\r\n\u2502 \ud83d\udce7 UNIFIED TEMP MAIL DASHBOARD \u2502\r\n\u251c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524\r\n\u2502 \ud83d\udcee test@boomlify.com \u2502 \ud83d\udcec New: Welcome Email \u2502\r\n\u2502 \ud83d\udcee temp@secure-mail.biz \u2502 \ud83d\udcec New: Verification Code \u2502\r\n\u2502 \ud83d\udcee trial@disposable.me \u2502 \ud83d\udcec New: Newsletter Signup \u2502\r\n\u2502 \ud83d\udcee business@yourdomain.com\u2502 \ud83d\udcec New: Account Activation \u2502\r\n\u2502 \ud83d\udcee gmail-temp@gmail.com \u2502 \ud83d\udcec New: Payment Confirmation \u2502\r\n\u251c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524\r\n\u2502 \ud83d\udd04 Real-time \u2022 \ud83d\udd12 Private \u2022 \u23f0 2+ months \u2022 \ud83c\udf10 16+ languages \u2502\r\n\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\r\n```\r\n\r\n### \ud83d\udce7 **Complete Temporary Email Use Cases**\r\n\r\n[Boomlify temporary email service](https://boomlify.com) excels in every scenario:\r\n\r\n#### \ud83e\uddea **Testing & Development**\r\n- **Email verification testing**: Test signup flows with [disposable emails](https://boomlify.com)\r\n- **API integration testing**: Validate email notifications in applications\r\n- **Load testing**: Generate bulk [temporary emails](https://boomlify.com) for performance testing\r\n- **Webhook testing**: Receive email notifications for webhook validation\r\n- **CI/CD integration**: Automated testing with unique email addresses\r\n- **A/B testing**: Multiple [temp emails](https://boomlify.com) for campaign testing\r\n- **Bug tracking**: Isolate issues with dedicated test emails\r\n- **Demo environments**: Clean email addresses for demonstrations\r\n\r\n#### \ud83d\udd12 **Privacy & Security Protection**\r\n- **Anonymous registrations**: Sign up without revealing real email\r\n- **Spam prevention**: Protect main inbox from unwanted messages\r\n- **Data breach protection**: Isolate sensitive communications\r\n- **Identity shielding**: Hide personal information during transactions\r\n- **Marketing avoidance**: Bypass promotional email lists\r\n- **Phishing protection**: Use [throwaway emails](https://boomlify.com) for suspicious sites\r\n- **Social media privacy**: Create accounts without email exposure\r\n- **Online shopping**: Protect personal email during purchases\r\n\r\n#### \ud83c\udfe2 **Business & Enterprise Applications**\r\n- **Customer onboarding**: Streamline registration processes\r\n- **Vendor communications**: Temporary channels for supplier interactions\r\n- **Event management**: Time-limited emails for registrations\r\n- **Customer support**: Protect team emails from external exposure\r\n- **Lead generation**: Capture prospects without permanent commitments\r\n- **Partnership outreach**: Professional temporary communication channels\r\n- **Compliance testing**: Validate email workflows for regulations\r\n- **Employee training**: Safe email addresses for training scenarios\r\n\r\n#### \ud83c\udf93 **Educational & Research**\r\n- **Course registrations**: [Temporary email addresses](https://boomlify.com) for online courses\r\n- **Research participation**: Anonymous email for studies\r\n- **Academic trials**: Access educational resources without commitment\r\n- **Student projects**: Clean email addresses for assignments\r\n- **Conference registration**: Event-specific temporary emails\r\n- **Webinar attendance**: One-time registration addresses\r\n- **Survey participation**: Anonymous feedback collection\r\n- **Beta testing**: Educational software evaluation\r\n\r\n### \ud83c\udf10 **Global Temporary Email Infrastructure**\r\n\r\n#### \ud83d\ude80 **Performance Metrics**\r\n- **\u26a1 Sub-200ms response times** worldwide\r\n- **\ud83c\udf0d 99.9% global uptime** guarantee\r\n- **\ud83d\udd04 Auto-scaling to millions** of concurrent users\r\n- **\ud83d\udce1 CDN-powered delivery** for instant access\r\n- **\ud83c\udfce\ufe0f Real-time WebSocket** notifications\r\n- **\u2696\ufe0f Intelligent load balancing** across continents\r\n\r\n#### \ud83d\udd10 **Security Standards**\r\n- **\ud83d\udee1\ufe0f SOC 2 Type II certified** enterprise security\r\n- **\ud83d\udd12 End-to-end encryption** for all communications\r\n- **\ud83c\udd94 Zero-knowledge architecture** ensuring privacy\r\n- **\ud83d\udccb GDPR & CCPA compliant** data handling\r\n- **\ud83d\udd10 Advanced threat protection** against malicious content\r\n- **\ud83d\udee1\ufe0f Multi-factor authentication** for account security\r\n\r\n### \ud83d\udcf1 **Multi-Platform Temporary Email Access**\r\n\r\n#### \ud83c\udf1f **Available Everywhere**\r\n- **\ud83d\udcbb Web Application**: Full-featured [temporary email dashboard](https://boomlify.com)\r\n- **\ud83d\udcf1 iOS App**: Native iPhone and iPad [temp mail](https://boomlify.com) experience\r\n- **\ud83e\udd16 Android App**: Complete Android [disposable email](https://boomlify.com) solution\r\n- **\ud83c\udf10 Progressive Web App**: App-like experience in any browser\r\n- **\ud83d\udcbb Desktop Apps**: Windows, macOS, and Linux applications\r\n- **\u2328\ufe0f CLI Tools**: Command-line interface for developers\r\n- **\ud83d\udd17 Browser Extensions**: Chrome, Firefox, Safari, and Edge plugins\r\n\r\n#### \ud83d\udd04 **Cross-Platform Synchronization**\r\n- **\ud83d\udcf1 Real-time sync** across all devices\r\n- **\u2601\ufe0f Cloud backup** of temporary email data\r\n- **\ud83d\udd04 Automatic updates** when emails arrive\r\n- **\ud83d\udcca Unified analytics** across all platforms\r\n- **\ud83c\udfaf Consistent experience** regardless of access method\r\n\r\n## \ud83d\udcc8 Getting Started with Boomlify\r\n\r\n1. **Sign up** at [Boomlify.com](https://boomlify.com) for your free account\r\n2. **Get your API key** from the dashboard\r\n3. **Install** the Python package: `pip install boomlify`\r\n4. **Start creating** temporary emails in minutes!\r\n\r\n## \ud83d\udd17 Useful Links\r\n\r\n- \ud83c\udf10 **Official Website**: [Boomlify.com](https://boomlify.com)\r\n- \ud83d\udcda **API Documentation**: [Boomlify.com/docs](https://boomlify.com/docs)\r\n- \ud83c\udfae **Interactive Demo**: [Boomlify.com/demo](https://boomlify.com/demo)\r\n- \ud83d\udcac **Community Support**: [Boomlify.com/community](https://boomlify.com/community)\r\n- \ud83d\udce7 **Email Support**: support@boomlify.com\r\n- \ud83d\udc1b **Bug Reports**: [GitHub Issues](https://github.com/boomlify/boomlify-python/issues)\r\n\r\n## Contributing\r\n\r\nWe welcome contributions! Please feel free to submit a Pull Request.\r\n\r\n## License\r\n\r\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\r\n\r\n---\r\n\r\n**[Boomlify](https://boomlify.com) - The Ultimate Temporary Email Solution**\r\n\r\n*Create temporary emails instantly | Disposable email API | Temp mail service | Email testing tools*\r\n\r\n\u00a9 2024 Boomlify. All rights reserved. | [Privacy Policy](https://boomlify.com/privacy) | [Terms of Service](https://boomlify.com/terms) \r\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Python client for Boomlify temporary email API",
"version": "1.0.1",
"project_urls": {
"Bug Tracker": "https://github.com/boomlify/boomlify-python/issues",
"Documentation": "https://boomlify.com/docs",
"Homepage": "https://boomlify.com",
"Repository": "https://github.com/boomlify/boomlify-python"
},
"split_keywords": [
"email",
" temporary",
" temp",
" mail",
" api",
" boomlify",
" disposable",
" testing",
" automation"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "90f2219a03f3cc5b78d405e34ee93762a1daa1ec0b01cc74a0d83d0a46a1c451",
"md5": "4a42d9adafa9de981261489fe4c9e2e8",
"sha256": "5dc10a03e30aa7d65456784ec230dfc438c79a264148671d8bbfdefcf2bd291e"
},
"downloads": -1,
"filename": "boomlify-1.0.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "4a42d9adafa9de981261489fe4c9e2e8",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 18633,
"upload_time": "2025-07-09T16:51:07",
"upload_time_iso_8601": "2025-07-09T16:51:07.219139Z",
"url": "https://files.pythonhosted.org/packages/90/f2/219a03f3cc5b78d405e34ee93762a1daa1ec0b01cc74a0d83d0a46a1c451/boomlify-1.0.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "d3edd86e70134de120d1e1767523fc10190e523ef2eea1eab72de597b52fd0e9",
"md5": "d0fe63af777094bdf6a260a11c8476d9",
"sha256": "17f6b308e42dcf6f8103407bc0e0d51d2a78a383f73d2bef8880ea5644d487e0"
},
"downloads": -1,
"filename": "boomlify-1.0.1.tar.gz",
"has_sig": false,
"md5_digest": "d0fe63af777094bdf6a260a11c8476d9",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 38632,
"upload_time": "2025-07-09T16:51:09",
"upload_time_iso_8601": "2025-07-09T16:51:09.539597Z",
"url": "https://files.pythonhosted.org/packages/d3/ed/d86e70134de120d1e1767523fc10190e523ef2eea1eab72de597b52fd0e9/boomlify-1.0.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-09 16:51:09",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "boomlify",
"github_project": "boomlify-python",
"github_not_found": true,
"lcname": "boomlify"
}