https://api.drin.run. Authenticate every request with your API key in the Authorization header. You can run your first POST /v1/emails the moment you have a key — no DNS required in test mode.
Base URL
Conventions
Requests and responses are JSON. SendContent-Type: application/json on any request with a body. Field names are camelCase; timestamps are ISO 8601 (2026-06-02T17:04:00Z); identifiers are opaque strings — treat them as such and never parse them.
Authentication
Authorization: Bearer <key>, plus X-Drin-Product to name a project for account-wide keys.Errors
A consistent
{ "error": { "type", "message" } } envelope on every non-2xx response.Pagination
Cursor pages:
?limit, ?cursor, nextCursor.Rate limits
429 with a Retry-After header when you go too fast.Versioning
Every path is prefixed with/v1. We add fields and endpoints without bumping the version — new optional response fields and new query parameters are not breaking changes, so write your client to ignore unknown fields. A breaking change would ship under a new version prefix.
Pagination
List endpoints return a cursor page. Pass?limit (1–100) and ?cursor (the previous response’s nextCursor). When nextCursor is null, you’ve reached the end.
Page shape
Idempotency
Send anIdempotency-Key header on a POST to make it safe to retry — the same key replays the original result for 24 hours, per project, so a retried send never duplicates. See Idempotency & retries.
Status codes
Drin uses conventional HTTP status codes.Request IDs. Every response echoes an
X-Request-Id header. Include it when you contact support — it lets us find the exact request in our logs.Send your first request
The quickstart walks through a real
POST /v1/emails end to end.