Python SDK

UNOSEND_API_KEY=un_your_api_key

import os
from unosend import Unosend

unosend = Unosend(os.environ["UNOSEND_API_KEY"])

from unosend import Unosend

# Initialize with your API key
unosend = Unosend("un_your_api_key")

# Send an email
response = unosend.emails.send(
    from_address="hello@yourdomain.com",
    to="user@example.com",
    subject="Welcome!",
    html="<h1>Hello!</h1><p>Welcome to our platform.</p>"
)

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

# Successful response
response.data  # Contains the result
response.error  # None on success

# Example successful data
{
    "id": "em_xxxxxxxxxxxxxxxxxxxxxxxx",
    "from": "hello@yourdomain.com",
    "to": ["user@example.com"],
    "subject": "Welcome!",
    "status": "queued",
    "created_at": "2024-01-15T10:30:00Z"
}

# Error response
response.data   # None on error
response.error  # ApiError object
response.error.message  # "Invalid API key"
response.error.code     # 401

from unosend import Unosend

unosend = Unosend("un_your_api_key")

# Send to multiple recipients
response = unosend.emails.send(
    from_address="hello@yourdomain.com",
    to=["user1@example.com", "user2@example.com"],
    subject="Team Update",
    html="<h1>Important Update</h1>",
    cc=["manager@example.com"],
    bcc=["archive@example.com"],
    reply_to="support@yourdomain.com"
)

from unosend import Unosend

unosend = Unosend("un_your_api_key")

# Add a domain
response = unosend.domains.create("yourdomain.com")
print(f"Domain added: {response.data.id}")
print(f"DNS Records to add: {response.data.records}")

# List all domains
response = unosend.domains.list()
for domain in response.data:
    print(f"{domain.name} - {domain.status}")

# Verify domain DNS
response = unosend.domains.verify(domain_id)
print(f"Domain status: {response.data.status}")

# Delete a domain
unosend.domains.delete(domain_id)

from unosend import Unosend

unosend = Unosend("un_your_api_key")

# Create an audience
response = unosend.audiences.create("Newsletter Subscribers")
audience_id = response.data.id
print(f"Audience created: {audience_id}")

# Add contacts to the audience
response = unosend.contacts.create(
    audience_id,
    email="user@example.com",
    first_name="John",
    last_name="Doe"
)
print(f"Contact added: {response.data.id}")

# List contacts
response = unosend.contacts.list(audience_id)
for contact in response.data:
    print(f"{contact.email} - {contact.first_name}")

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

# Delete a contact
unosend.contacts.delete(contact_id)

from unosend import Unosend

unosend = Unosend("un_your_api_key")

response = unosend.emails.send(
    from_address="hello@yourdomain.com",
    to="user@example.com",
    subject="Test",
    html="<p>Hello</p>"
)

# Check for errors
if response.error:
    print(f"Error {response.error.code}: {response.error.message}")
else:
    print(f"Success! Email ID: {response.data.id}")

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

from unosend import Unosend

with Unosend("un_your_api_key") as unosend:
    response = unosend.emails.send(
        from_address="hello@yourdomain.com",
        to="user@example.com",
        subject="Hello!",
        html="<p>World</p>"
    )
# Client is automatically closed

from unosend import Unosend

unosend = Unosend("un_your_api_key")

# Send with custom headers and tags
response = unosend.emails.send(
    from_address="hello@yourdomain.com",
    to="user@example.com",
    subject="Order Confirmation",
    html="<h1>Order #12345</h1>",
    headers={
        "X-Order-ID": "12345",
        "X-Customer-ID": "cust_abc"
    },
    tags=[
        {"name": "campaign", "value": "order-confirmation"},
        {"name": "order_id", "value": "12345"}
    ]
)