unosend 1.0.0

Official Python SDK for Unosend - Email API Service

unosend

Official Python SDK for Unosend - Email API Service.

Installation

pip install unosend

Quick Start

from unosend import Unosend

unosend = Unosend("un_your_api_key")

# Send an email
response = unosend.emails.send(
    from_address="[e-mail]",
    to="[e-mail]",
    subject="Hello from Unosend!",
    html="<h1>Welcome!</h1><p>Thanks for signing up.</p>"
)

if response.error:
    print(f"Failed to send: {response.error.message}")
else:
    print(f"Email sent: {response.data.id}")

Features

• 📧 Emails - Send transactional emails with HTML/text content
• 🌐 Domains - Manage and verify sending domains
• 👥 Audiences - Create and manage contact lists
• 📇 Contacts - Add, update, and remove contacts

API Reference

Emails

# Send an email
response = unosend.emails.send(
    from_address="[e-mail]",
    to=["[e-mail]", "[e-mail]"],
    subject="Hello!",
    html="<h1>Hello World</h1>",
    text="Hello World",  # Optional plain text version
    reply_to="[e-mail]",
    cc=["[e-mail]"],
    bcc=["[e-mail]"],
    headers={"X-Custom-Header": "value"},
    tags=[{"name": "campaign", "value": "welcome"}]
)

# Get email by ID
response = unosend.emails.get("email_id")

# List emails
response = unosend.emails.list(limit=10, offset=0)

Domains

# Add a domain
response = unosend.domains.create("yourdomain.com")

# Verify domain DNS records
response = unosend.domains.verify("domain_id")

# List domains
response = unosend.domains.list()

# Delete domain
response = unosend.domains.delete("domain_id")

Audiences

# Create an audience
response = unosend.audiences.create("Newsletter Subscribers")

# List audiences
response = unosend.audiences.list()

# Get audience
response = unosend.audiences.get("audience_id")

# Delete audience
response = unosend.audiences.delete("audience_id")

Contacts

# Add a contact
response = unosend.contacts.create(
    "audience_id",
    email="[e-mail]",
    first_name="John",
    last_name="Doe"
)

# List contacts in an audience
response = unosend.contacts.list("audience_id")

# Update a contact
response = unosend.contacts.update(
    "contact_id",
    first_name="Jane",
    unsubscribed=False
)

# Delete a contact
response = unosend.contacts.delete("contact_id")

Error Handling

All methods return an ApiResponse with data and error attributes:

response = unosend.emails.send(...)

if response.error:
    print(f"Error {response.error.code}: {response.error.message}")
else:
    print(f"Success: {response.data}")

# Or use tuple unpacking
data, error = unosend.emails.send(...)
if error:
    print(f"Failed: {error.message}")

Configuration

# Custom base URL (for self-hosted instances)
unosend = Unosend(
    "un_your_api_key",
    base_url="https://your-instance.com/api/v1"
)

Context Manager

with Unosend("un_your_api_key") as unosend:
    response = unosend.emails.send(...)
# Client is automatically closed

License

MIT