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

SendGrid

Configure SendGrid regional Mail Send and opt-in native personalization.

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

Configure the account

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

export const configuredSendgridAccount = (apiKey: Redacted.Redacted) =>
  sendgridEmailLayer({ apiKey, region: "Global" }).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

  • Choose Global or Europe explicitly when account placement matters. Region selection does not create a new replay guarantee.
  • Sender display names must be ASCII. Reserved X-SG-ID and X-SG-EID headers cannot be overridden.
  • Schedules require a future whole UTC second within 72 hours. Metadata becomes custom arguments and tags become categories.
  • For grouped audiences, use sendgridPersonalizedEmailLayer deliberately; see the personalization guide.

Idempotency

Idempotency keys are not supported. The SDK does not retry requests with unknown submission outcomes.

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.