Metadata-Version: 2.4
Name: mailstein
Version: 0.2.10
Summary: Python SDK for the Mailstein API
License: MIT
License-File: LICENSE
Author: Mailstein
Requires-Python: >=3.10,<4.0
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Requires-Dist: requests (>=2.33.0,<3.0.0)
Requires-Dist: typing_extensions (>=4.7)
Requires-Dist: urllib3 (>=2.7.0,<3.0.0)
Description-Content-Type: text/markdown

# mailstein

Official Python SDK for [mailstein](https://mailstein.com) — send transactional and broadcast email from infrastructure you control.

## Install

```bash
pip install mailstein
```

## Usage

```python
from mailstein import Mailstein

client = Mailstein("ms_your_api_key")

email, err = client.emails.send({
    "from": "hello@yourdomain.com",
    "to": "customer@example.com",
    "subject": "Welcome aboard",
    "html": "<h1>You're in.</h1>",
})
if err:
    raise RuntimeError(err)
```

Methods return a `(result, error)` tuple. The client exposes `emails`, `domains`,
`contacts`, `contact_books`, `campaigns`, and `webhooks`.

## Documentation

Full reference: **https://mailstein.com/docs**

## License

MIT

