Quickstart - Drin

Send your first email in under a minute. You need two things — an API key and a from address — and Drin gives you a shared onboarding domain so you can send before touching DNS.

Get an API key

Create one in the dashboard under API Keys. The secret is shown once — store it somewhere safe, for example as DRIN_API_KEY.

Already have one. New accounts get a key automatically during onboarding, baked into the in-dashboard snippets. This page is the version you can copy anywhere.

Send your first email

Every snippet hits the same contract: POST https://api.drin.run/v1/emails with a from, a to array, and subject + html (or text).

curl https://api.drin.run/v1/emails \
  -H "Authorization: Bearer $DRIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from": { "email": "onboarding@yourdomain.com" },
    "to": [{ "email": "you@example.com" }],
    "subject": "Hello from Drin",
    "html": "<p>It works!</p>"
  }'

// npm install @drin00/sdk
import { DrinClient } from "@drin00/sdk";

const drin = new DrinClient({ apiKey: process.env.DRIN_API_KEY });

await drin.emails.send({
  from: { email: "onboarding@yourdomain.com" },
  to: [{ email: "you@example.com" }],
  subject: "Hello from Drin",
  html: "<p>It works!</p>",
});

import os, requests

requests.post(
    "https://api.drin.run/v1/emails",
    headers={"Authorization": f"Bearer {os.environ['DRIN_API_KEY']}"},
    json={
        "from": {"email": "onboarding@yourdomain.com"},
        "to": [{"email": "you@example.com"}],
        "subject": "Hello from Drin",
        "html": "<p>It works!</p>",
    },
)

payload := []byte(`{
  "from": { "email": "onboarding@yourdomain.com" },
  "to": [{ "email": "you@example.com" }],
  "subject": "Hello from Drin",
  "html": "<p>It works!</p>"
}`)
req, _ := http.NewRequest("POST", "https://api.drin.run/v1/emails", bytes.NewReader(payload))
req.Header.Set("Authorization", "Bearer "+os.Getenv("DRIN_API_KEY"))
req.Header.Set("Content-Type", "application/json")
http.DefaultClient.Do(req)

require "net/http"; require "json"; require "uri"

uri = URI("https://api.drin.run/v1/emails")
http = Net::HTTP.new(uri.host, uri.port); http.use_ssl = true
req = Net::HTTP::Post.new(uri)
req["Authorization"] = "Bearer #{ENV.fetch('DRIN_API_KEY')}"
req["Content-Type"] = "application/json"
req.body = {
  from: { email: "onboarding@yourdomain.com" },
  to: [{ email: "you@example.com" }],
  subject: "Hello from Drin", html: "<p>It works!</p>"
}.to_json
http.request(req)

<?php
$ch = curl_init("https://api.drin.run/v1/emails");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer " . getenv("DRIN_API_KEY"),
        "Content-Type: application/json",
    ],
    CURLOPT_POSTFIELDS => json_encode([
        "from" => ["email" => "onboarding@yourdomain.com"],
        "to" => [["email" => "you@example.com"]],
        "subject" => "Hello from Drin",
        "html" => "<p>It works!</p>",
    ]),
]);
echo curl_exec($ch);

A 202 Accepted with a message id means it’s queued. Java, C#, Rust, Elixir, Kotlin, Swift and a no-code SMTP recipe are all in the dashboard’s in-app quickstart too.

Watch it land

Every send shows up on Email Activity within seconds, with its full transit log — queued → sent → delivered → opened. Or fetch it over the API: GET /v1/emails/{id}.

Send from your own domain

The shared onboarding domain runs in test mode — it can only deliver to your own address. To email anyone from your own brand, verify a domain on the Domains page (DKIM + SPF + DMARC, guided). Then list your verified domains in code and use one as your from:

Node.js

const [d] = await drin.domains.listVerified();

await drin.emails.send({
  from: { email: `hello@${d.domain}` },
  to: [{ email: "customer@example.com" }],
  subject: "Welcome aboard",
  html: "<p>Glad you're here.</p>",
});

Account-wide keys. A key that isn’t scoped to a single project must name the sending project per request with the X-Drin-Product: <project-id> header — or the SDK’s sender option. Project-scoped keys don’t need it. See Authentication.

Next steps

Templates

Store reusable HTML with {{merge}} variables and send by templateId.

Receive email

Turn on receiving, create an inbox, and reply in-thread.

Webhooks

Get delivery, bounce, complaint, open and click events in real time.

Give an agent email

Wire the MCP server into Claude, Cursor, or your own agent.

AuthenticationBearer API keys, project scoping, the X-Drin-Product header, and idempotent requests.

​Next steps

Templates

Receive email

Webhooks

Give an agent email

Next steps