Skip to main content

Free disposable email API client — create temp inboxes, receive emails, and send emails. No auth required.

Project description

NenzMail — Free Disposable Email API Client (Python)

Send and receive disposable emails from your Python apps. No authentication, no API keys, no signup. Uses only the standard library — no dependencies.

Install

pip install nenzmail

Quick Start

import nenzmail

# Create a temp inbox
inbox = nenzmail.create_inbox()
print(inbox['email'])  # purplecat209@nenzmail.xyz

# Check for emails
result = nenzmail.get_emails(inbox['email'])
print(result['emails'])

# Read full email
email = nenzmail.get_email(result['emails'][0]['id'])

# Send an email — free!
nenzmail.send_email(
    from_addr=inbox['email'],
    to='friend@gmail.com',
    subject='Hello from NenzMail',
    text='This was sent from a free temp inbox!',
)

# Delete inbox when done
nenzmail.delete_inbox(inbox['email'])

API

create_inbox(domain='nenzmail.xyz', username=None)

Create a new temporary inbox. Auto-deletes after 1 hour.

  • domainnenzmail.xyz (default), nzmail.xyz, or zlkcyber.xyz
  • username — Custom username (3-30 chars: letters, numbers, _ or -)

get_emails(address)

List all emails in an inbox. Returns {'emails': [...]}.

get_email(email_id)

Read full email content (HTML + text).

send_email(from_addr, to, subject, text='', html='', reply_to=None)

Send an email from your inbox to any address. Rate limited: 20/hr per inbox.

delete_inbox(address)

Delete an inbox immediately.

get_sent_emails(address)

Get sent emails (outbox) for an inbox.

check_username(username, domain='nenzmail.xyz')

Check if a custom username is available.

get_domains()

List available domains.

Features

  • 🆓 100% Free — no costs, no credit card
  • 🔓 No Auth — no API keys, no tokens
  • 📧 Send & Receive — most temp mail only receives
  • ⏱️ Auto-Delete — inboxes expire after 1 hour
  • 📦 Zero Dependencies — uses only Python standard library

Links

License

MIT

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

nenzmail-1.0.0.tar.gz (3.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

nenzmail-1.0.0-py3-none-any.whl (4.0 kB view details)

Uploaded Python 3

File details

Details for the file nenzmail-1.0.0.tar.gz.

File metadata

  • Download URL: nenzmail-1.0.0.tar.gz
  • Upload date:
  • Size: 3.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.15

File hashes

Hashes for nenzmail-1.0.0.tar.gz
Algorithm Hash digest
SHA256 796848a5638cbf56233c3f9a65114908b59ea74b7249d4f686e0dbcb3fab3ee9
MD5 a1f9808e74f75cca4fd9de4eaa26d2ba
BLAKE2b-256 904b8c1a91e9d52bc33e1c861dcbdc3ebc30811108785f3f9f02931a52785e5d

See more details on using hashes here.

File details

Details for the file nenzmail-1.0.0-py3-none-any.whl.

File metadata

  • Download URL: nenzmail-1.0.0-py3-none-any.whl
  • Upload date:
  • Size: 4.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.15

File hashes

Hashes for nenzmail-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 88c96de2b11369610a7034cd04fc42a970d294957a095b1d58130862225726cc
MD5 fcf876848e2640e9c09a0763993e20a1
BLAKE2b-256 a58fceccb1cc2133b383c49c315da63a4d1798d706c511200966241894ad2c5f

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page