> For the complete documentation index, see [llms.txt](https://reno.gitbook.io/smtp-py/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://reno.gitbook.io/smtp-py/readme.md).

# Welcome

`smtp-py` là Python client cho smtp.dev API.

Bạn dùng nó để quản lý:

* Domains
* Accounts
* Mailboxes
* Messages (bao gồm source, move, download attachment)
* API Tokens

### Checklist bắt đầu nhanh

* [ ] Cài package: xem [Installing](/smtp-py/getting-started/publish-your-docs.md)
* [ ] Tạo API key tại `https://smtp.dev/tokens/`
* [ ] Set `XAPIKEY` hoặc `X_API_KEY` (hoặc truyền `api_key` trực tiếp)
* [ ] Khởi tạo `SMTPDevClient`
* [ ] Gọi thử `list_domains()` hoặc `list_accounts()`

### Điều hướng nhanh

<table data-view="cards"><thead><tr><th>Chủ đề</th><th data-card-target data-type="content-ref">Mở</th></tr></thead><tbody><tr><td><strong>Installing</strong></td><td><a href="/spaces/gFJFUMjMj7UZO8vl2omO/pages/JjjojIyKxaiBPzzLwvtg">/spaces/gFJFUMjMj7UZO8vl2omO/pages/JjjojIyKxaiBPzzLwvtg</a></td></tr><tr><td><strong>Usage</strong></td><td><a href="/spaces/gFJFUMjMj7UZO8vl2omO/pages/CyH2xJQs9yWJ1S8BYNav">/spaces/gFJFUMjMj7UZO8vl2omO/pages/CyH2xJQs9yWJ1S8BYNav</a></td></tr><tr><td><strong>Client setup</strong></td><td><a href="/spaces/gFJFUMjMj7UZO8vl2omO/pages/aJ3CiczmhyYcAtoPbgDW">/spaces/gFJFUMjMj7UZO8vl2omO/pages/aJ3CiczmhyYcAtoPbgDW</a></td></tr><tr><td><strong>Domain APIs</strong></td><td><a href="/spaces/gFJFUMjMj7UZO8vl2omO/pages/7aUFmnCMx9m4smGncsXL">/spaces/gFJFUMjMj7UZO8vl2omO/pages/7aUFmnCMx9m4smGncsXL</a></td></tr><tr><td><strong>Account APIs</strong></td><td><a href="/spaces/gFJFUMjMj7UZO8vl2omO/pages/LTp51kErY5609ZyA7Bok">/spaces/gFJFUMjMj7UZO8vl2omO/pages/LTp51kErY5609ZyA7Bok</a></td></tr><tr><td><strong>Mailbox APIs</strong></td><td><a href="/spaces/gFJFUMjMj7UZO8vl2omO/pages/4o8gn14awMlC1ep7yW3o">/spaces/gFJFUMjMj7UZO8vl2omO/pages/4o8gn14awMlC1ep7yW3o</a></td></tr><tr><td><strong>Message APIs</strong></td><td><a href="/spaces/gFJFUMjMj7UZO8vl2omO/pages/y7gz5lJHrLGBD9xz6XHh">/spaces/gFJFUMjMj7UZO8vl2omO/pages/y7gz5lJHrLGBD9xz6XHh</a></td></tr><tr><td><strong>Token APIs</strong></td><td><a href="/spaces/gFJFUMjMj7UZO8vl2omO/pages/Mj9Yjl7kNeLRUo0yzD0p">/spaces/gFJFUMjMj7UZO8vl2omO/pages/Mj9Yjl7kNeLRUo0yzD0p</a></td></tr></tbody></table>

{% hint style="info" %}
Tất cả ví dụ bên dưới dùng API kiểu mới: `SMTPDevClient` + method dạng `snake_case`.
{% endhint %}