Skip to content
Corven Email SDK
Esc
↑↓navigate↵open⌘Jpreview
On this page

Lettermint

Send through a Lettermint route with native keys and sandbox-aware receipts.

Import lettermintEmailLayer from @corven/email-sdk/lettermint to provide the common Email service for this account.

Configure the account

import { Layer } from "effect";
import type { Redacted } from "effect";
import { lettermintEmailLayer } from "@corven/email-sdk/lettermint";
import { emailHttpLayer } from "./sending.js";

export const configuredLettermintAccount = (apiToken: Redacted.Redacted) =>
  lettermintEmailLayer({ apiToken, route: "transactional" }).pipe(Layer.provide(emailHttpLayer));

The example reuses the explicit HTTP Layer. Acquire credentials in trusted host code, then provide this account Layer to your sending program.

Message behavior

  • Use apiToken and, optionally, a route slug. A route slug selects provider configuration; it is not an SDK fallback route.
  • Both explicit and provider-selected attachment MIME types are supported. Custom headers, metadata, scheduling and bounded ASCII tags are available.
  • Sandbox acknowledgment is reported as Simulated. A sandbox delivered label is not live delivery evidence.

Idempotency

Native idempotency applies to the configured account for 24 hours. Keys can contain up to 255 characters. The SDK stops retries after a payload conflict.

Read field support before switching accounts, and receipts and retries before adding recovery behavior. Configuration and local validation do not authenticate the account or prove delivery.