Skip to Content
Docs

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:

LanguagePackage / LibraryInstallationGuide
TypeScript / Node.js@emitd/sdknpm install @emitd/sdkExpress / Next.js
Pythonemitdpip install emitdFastAPI / Django
Goemitdgo get github.com/emitd/go-sdkGo Guide
Rubyemitdgem install emitdRails Guide
PHPemitd/emitd-phpcomposer require emitd/emitd-phpAPI Reference
Rustemitdcargo add emitdAPI Reference
Java / Kotlincom.emitd:emitd-javaMaven / GradleAPI Reference
C# / .NETEmitddotnet add package EmitdAPI Reference
Elixiremitd{: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/http and 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/mcp for Claude Code, Cursor, and autonomous agents.

On this page