buchida 0.1.0

Official Python SDK for buchida email API

buchida

Official Python SDK for the buchida email API.

Installation

pip install buchida

Quick Start

from buchida import Buchida

client = Buchida("bc_live_xxxxxxxxxxxxxxxxxxxxx")

# Send an email
result = client.emails.send(
    from_="[e-mail]",
    to="[e-mail]",
    subject="Welcome to buchida!",
    html="<h1>Hello!</h1><p>Welcome aboard.</p>",
)

print(f"Email sent: {result['id']}")

Features

• Full type hints
• Zero dependencies (stdlib urllib)
• Python 3.10+
• Typed dataclass responses

API Reference

Emails

client.emails.send(from_="...", to="...", subject="...", html="...", text="...")
client.emails.send_batch([{"from": "...", "to": "...", "subject": "..."}])
client.emails.get("email_id")
client.emails.list(limit=10, status="delivered")
client.emails.cancel("email_id")

Domains

client.domains.create(name="yourdomain.com")
client.domains.list()
client.domains.get("domain_id")
client.domains.verify("domain_id")

API Keys

client.api_keys.create(name="Production", permission="full_access")
client.api_keys.list()
client.api_keys.delete("key_id")

Webhooks

client.webhooks.create(url="https://example.com/webhook", events=["email.delivered"])
client.webhooks.list()
client.webhooks.delete("webhook_id")

Templates

client.templates.list()
client.templates.get("template_id")

Metrics

client.metrics.get(from_="2026-03-01", to="2026-03-31", granularity="day")

Error Handling

from buchida import Buchida, AuthenticationError, RateLimitError, BuchidaError

try:
    client.emails.send(...)
except AuthenticationError:
    # 401 - invalid API key
    pass
except RateLimitError:
    # 429 - too many requests
    pass
except BuchidaError as e:
    # Other API errors
    print(e.status_code, e.message)

License

MIT