SDKs & CLI
Official SDKs for nine languages generated from the OpenAPI spec, native HTTPS API, and Model Context Protocol (MCP) tooling.
The raw HTTPS API is always sufficient — no SDK required. When you want typed clients, IDE autocomplete, and retries handled for you, emitd provides official SDKs generated directly from the OpenAPI spec:
| Language | Package / Library | Installation | Guide |
|---|---|---|---|
| TypeScript / Node.js | @emitd/sdk | npm install @emitd/sdk | Express / Next.js |
| Python | emitd | pip install emitd | FastAPI / Django |
| Go | emitd | go get github.com/emitd/go-sdk | Go Guide |
| Ruby | emitd | gem install emitd | Rails Guide |
| PHP | emitd/emitd-php | composer require emitd/emitd-php | API Reference |
| Rust | emitd | cargo add emitd | API Reference |
| Java / Kotlin | com.emitd:emitd-java | Maven / Gradle | API Reference |
| C# / .NET | Emitd | dotnet add package Emitd | API Reference |
| Elixir | emitd | {:emitd, "~> 0.1"} | API Reference |
There is also an emitd CLI for key management, domain status inspection, and ad-hoc testing.
Code examples by language
import { Emitd } from "@emitd/sdk";
const emitd = new Emitd({ apiKey: process.env.EMITD_API_KEY! });
const res = await emitd.email.send({
from: "hello@yourdomain.com",
to: ["user@example.com"],
subject: "Welcome to Acme!",
html_body: "<h1>Hello from emitd!</h1>",
message_stream: "outbound",
});
console.log(`Message queued: ${res.message_id}`);Framework guides
Looking to integrate with a specific framework or runtime? Follow our dedicated guides:
- Next.js — Server actions, App Router handlers, sandbox testing.
- Express & Node.js — TypeScript routes and HMAC webhook verification.
- FastAPI & Python — Async sending and Pydantic request models.
- Go — Native standard library
net/httpand webhook verification. - Ruby on Rails — Action Mailer adapter and delivery configuration.
- Django — Custom email backend integration.
Machine-readable specifications & AI agent endpoints
/openapi.yaml— full OpenAPI 3.1 specification describing every endpoint, parameter, and schema./llms.txt— compact plain-text reference tailored for LLM prompt context windows.- Hosted MCP Server — native Model Context Protocol server at
https://mcp.emitd.com/mcpfor Claude Code, Cursor, and autonomous agents.