Metadata-Version: 2.4
Name: utobo-email
Version: 1.0.0
Summary: Official Python SDK for the utobo email Email Platform
Project-URL: Homepage, https://utobo.com/email
Project-URL: Documentation, https://utobo.com/email/docs
Project-URL: Repository, https://github.com/myutobo/utobo-email-python
Project-URL: Issues, https://github.com/myutobo/utobo-email-python/issues
Author-email: Utobo <hello@mail.utobo.com>
License-Expression: MIT
Keywords: api,email,sdk,transactional,utobo
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Communications :: Email
Requires-Python: >=3.8
Requires-Dist: httpx>=0.24.0
Description-Content-Type: text/markdown

# utobo-email

Official Python SDK for the [utobo email](https://utobo.com/email) email platform.

## Install

```bash
pip install utobo-email
```

## Quickstart

```python
from utobo_email import UtoboEmail

client = UtoboEmail("av_live_...")

result = client.emails.send(
    from_="Acme <noreply@acme.com>",
    to="user@example.com",
    subject="Welcome!",
    html="<p>Welcome to Acme!</p>",
)
print(result["id"])
```

## Check delivery status

```python
status = client.emails.get("3c9b0f4e-...")
print(status["status"])  # "sent" | "failed"
```

## Configuration

| Option | Env var | Default |
|--------|---------|---------|
| `api_key` | `UTOBO_EMAIL_API_KEY` | — (required) |
| `base_url` | `UTOBO_EMAIL_BASE_URL` | `https://api.email.utobo.com/v1` |

## License

MIT
