mailpush 0.1.0

Official Mailpush SDK for Python

Mailpush Python SDK

Official Python SDK for the Mailpush email API.

Installation

pip install mailpush

Quick Start

from mailpush import Mailpush, SendEmailRequest

client = Mailpush("mp_live_xxx")

response = client.emails.send(SendEmailRequest(
    from_address="[e-mail]",
    to="[e-mail]",
    subject="Hello from Mailpush",
    html="<h1>Welcome!</h1>"
))

print(f"Email sent: {response.id}")

Features

• Simple, intuitive API
• Full type hints support
• Automatic retries on rate limits
• Support for attachments
• Template support with variables

Sending Emails

Basic Email

from mailpush import Mailpush, SendEmailRequest

client = Mailpush("mp_live_xxx")

response = client.emails.send(SendEmailRequest(
    from_address="[e-mail]",
    to="[e-mail]",
    subject="Welcome!",
    html="<h1>Hello World</h1>",
    text="Hello World"
))

With Multiple Recipients

response = client.emails.send(SendEmailRequest(
    from_address="[e-mail]",
    to=["[e-mail]", "[e-mail]"],
    cc="[e-mail]",
    bcc=["[e-mail]"],
    subject="Team Update",
    html="<p>Important update...</p>"
))

With Attachments

import base64
from mailpush import Mailpush, SendEmailRequest, Attachment

client = Mailpush("mp_live_xxx")

with open("report.pdf", "rb") as f:
    content = base64.b64encode(f.read()).decode()

response = client.emails.send(SendEmailRequest(
    from_address="[e-mail]",
    to="[e-mail]",
    subject="Your Report",
    html="<p>Please find attached your report.</p>",
    attachments=[
        Attachment(
            filename="report.pdf",
            content=content,
            content_type="application/pdf"
        )
    ]
))

Using Templates

response = client.emails.send(SendEmailRequest(
    from_address="[e-mail]",
    to="[e-mail]",
    template_id="welcome-template-id",
    variables={
        "name": "John",
        "company": "Acme Inc"
    }
))

Error Handling

from mailpush import (
    Mailpush,
    SendEmailRequest,
    AuthenticationError,
    ValidationError,
    RateLimitError,
    MailpushError
)

client = Mailpush("mp_live_xxx")

try:
    response = client.emails.send(SendEmailRequest(
        from_address="[e-mail]",
        to="[e-mail]",
        subject="Test",
        html="<p>Hello</p>"
    ))
except AuthenticationError:
    print("Invalid API key")
except ValidationError as e:
    print(f"Validation failed: {e.details}")
except RateLimitError as e:
    print(f"Rate limited. Retry after {e.retry_after} seconds")
except MailpushError as e:
    print(f"Error: {e.code} - {e}")

Configuration

Custom Base URL

client = Mailpush("mp_live_xxx", base_url="https://api.custom.com")

License

MIT