Send email in one typed call.

Install samva, pass your key, and call email.send. Then get back to the product. Or copy the setup brief and let your agent write the integration.

npm install samvaOpenAPI 3.1HOSTED MCP

import { createClient } from "samva";

const samva = createClient({ apiKey: process.env.SAMVA_API_KEY });

const message = await samva.email.send({
  to: "ada@example.com",
  subject: "Your order shipped",
  html: "<p>Order #1042 is on its way.</p>",
});

POST /v1/messages201 · msg_7q2xk9mvt4znw8rh

#01 — The API

Send, verify, generate from one contract.

SEND

POST /v1/messages
X-API-Key: samva_sk_live_...

{ "channel": "email",
  "to": [{ "email": "ada@example.com" }],
  "email": { "subject": "Your order shipped" } }

201  { "id": "msg_7q2xk9mvt4znw8rh", "status": "pending" }

One typed call. The compiler catches a bad payload before it ships.

SENDING AN EMAIL

WEBHOOKS & EVENTS

POST /webhooks/samva
webhook-id: whevt_7q2xk9mvt4znw8rh
webhook-timestamp: 1783503734
webhook-signature: v1,SGVsbG8...

{ "type": "message.delivered", "timestamp": "2026-07-08T09:42:14Z",
  "data": { "messageId": "msg_7q2xk9mvt4znw8rh" } }

verify({ body, id, timestamp, signature, secret })

Delivery, bounce, and inbound events, signed. Retries with backoff.

WEBHOOK REFERENCE

OPENAPI 3.1 & SDKS

# the typed TypeScript SDK
npm install samva

# the whole API, as one spec
GET https://api.samva.dev/v1/openapi.json
200 · openapi 3.1 · every endpoint, typed

Install the TypeScript SDK, or generate a client from OpenAPI 3.1.

OPENAPI SPEC

HOSTED MCP

{
  "mcpServers": {
    "samva": {
      "url": "https://mcp.samva.dev",
      "headers": { "X-API-Key": "samva_sk_live_..." }
    }
  }
}

Point your agent at mcp.samva.dev. Your agent gets templates, contacts, and delivery as tools. API key or OAuth.

HOSTED MCP

#02 — Effect-native

The SDK ships an Effect-native client too.

Import Pascal-cased modules from samva/effect/* and call operations directly. Each operation composes into your Effect v4 program.

import { Effect } from "effect";
import * as Client from "samva/effect/client";
import * as Email from "samva/effect/email";

const send = Email.send({ to, subject, html }).pipe(
  Effect.catchTags({
    RateLimitedError: (e) => Effect.sleep(e.retryAfterSeconds * 1_000),
    ValidationError: (e) => Effect.log(e.fields),
  }),
  Effect.provide(Client.layerFetch({ apiKey })),
);

Typed errors: Failures arrive as tagged errors you narrow with catchTags. RateLimitedError carries retryAfterSeconds, ValidationError carries the offending fields.
Layer-based services: Domain operations require Client.Service. Build Client.layerFetch once and provide it around the part of your program that calls Samva.
Schema-driven: Requests and responses are decoded through Schema, so a malformed payload fails at the boundary, not three calls later.

EFFECT SDK GUIDE

#03 — Agent tooling