> ## Documentation Index
> Fetch the complete documentation index at: https://docs.drin.run/llms.txt
> Use this file to discover all available pages before exploring further.
# SDKs & languages
> Official typed SDKs for TypeScript and Python, a full CLI, the MCP server, and the raw REST contract you can call from any language.
Every Drin capability is reachable from one account and one key. Use the typed
SDK in your language, the CLI for scripts and CI, the MCP server for agents — or
talk to the REST API directly from anything that speaks HTTP.
`@drin00/sdk` — typed client with retries, cursor pagination, and webhook verification.
`pip install drin` — the official Python client, same surface as the TS SDK.
Call the REST API with the standard `net/http` client — worked example below.
Use `Net::HTTP` or your HTTP client of choice against the REST contract.
A few lines of `curl` or Guzzle — the same JSON body as everywhere else.
No dependency. The raw HTTP contract, callable from any stack.
## Install
```bash TypeScript theme={null}
npm install @drin00/sdk
```
```bash Python theme={null}
pip install drin
```
```bash CLI theme={null}
npx -y @drin00/cli send --to you@example.com --subject "Hi" --text "It works"
```
## TypeScript / Node
The official client mirrors the wire contract one-to-one, with built-in
retries, async-iterator pagination, typed errors, and local webhook
verification.
```ts theme={null}
import { DrinClient } from "@drin00/sdk";
const drin = new DrinClient({ apiKey: process.env.DRIN_API_KEY! });
const { id } = await drin.emails.send({
from: { email: "hello@acme.com", name: "Acme" },
to: [{ email: "customer@example.com" }],
subject: "Welcome aboard",
html: "You're in
",
});
```
## Python
Same surface, Pythonic names. Published to PyPI as `drin`.
```python theme={null}
import os
from drin import DrinClient
drin = DrinClient(api_key=os.environ["DRIN_API_KEY"])
msg = drin.emails.send(
from_={"email": "hello@acme.com", "name": "Acme"},
to=[{"email": "customer@example.com"}],
subject="Welcome aboard",
html="You're in
",
)
print(msg["id"])
```
## Any language (REST)
No SDK? Every endpoint is a plain JSON request over HTTPS. Here's the same send
in Go, Ruby, and PHP.
```go Go theme={null}
body, _ := json.Marshal(map[string]any{
"from": "Acme ",
"to": "customer@example.com",
"subject": "Welcome aboard",
"html": "You're in
",
})
req, _ := http.NewRequest("POST", "https://api.drin.run/v1/emails", bytes.NewReader(body))
req.Header.Set("Authorization", "Bearer "+os.Getenv("DRIN_API_KEY"))
req.Header.Set("Content-Type", "application/json")
resp, _ := http.DefaultClient.Do(req)
```
```ruby Ruby theme={null}
require "net/http"
require "json"
uri = URI("https://api.drin.run/v1/emails")
req = Net::HTTP::Post.new(uri, {
"Authorization" => "Bearer #{ENV['DRIN_API_KEY']}",
"Content-Type" => "application/json",
})
req.body = { from: "Acme ", to: "customer@example.com",
subject: "Welcome aboard", html: "You're in
" }.to_json
Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |http| http.request(req) }
```
```php PHP theme={null}
$ch = curl_init("https://api.drin.run/v1/emails");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
"Authorization: Bearer " . getenv("DRIN_API_KEY"),
"Content-Type: application/json",
],
CURLOPT_POSTFIELDS => json_encode([
"from" => "Acme ",
"to" => "customer@example.com",
"subject" => "Welcome aboard",
"html" => "You're in
",
]),
]);
$response = curl_exec($ch);
```
Account-wide keys also take a `sender` (your project's external id) so requests
are scoped correctly. Project-scoped keys don't need it.