npm install simpleemailapi

pnpm add simpleemailapi

yarn add simpleemailapi

import { createClient } from 'simpleemailapi';

const client = createClient({
  apiKey: 'sea_live_...'
});

await client.send({
  from: 'onboarding@yourdomain.com',
  to: ['you@example.com'],
  subject: 'Hello from Simple Email API',
  body: 'It works!'
});

package main

import (
    "context"
    "log"

    emailapi "github.com/emailapi/sdk-go"
    v1 "github.com/emailapi/sdk-go/gen/v1"
)

func main() {
    client := emailapi.NewClient("sea_live_...")

    _, err := client.Send(context.Background(), &v1.SendEmailRequest{
        From:    "onboarding@yourdomain.com",
        To:      []string{"you@example.com"},
        Subject: "Hello from Simple Email API",
        Body:    "It works!",
    })
    if err != nil {
        log.Fatal(err)
    }
}

import { createClient } from "@connectrpc/connect";
import { createConnectTransport } from "@connectrpc/connect-node";
import { EmailService } from "@buf/simpleemailapi_public.connectrpc_es/v1/email_connect";

const transport = createConnectTransport({
  baseUrl: "https://api.simpleemailapi.dev",
  httpVersion: "2",
  interceptors: [
    (next) => async (req) => {
      req.header.set("Authorization", "Bearer sea_live_...");
      return next(req);
    },
  ],
});

const client = createClient(EmailService, transport);

// Access the raw Connect RPC client
await client.sendEmail({
  from: "onboarding@yourdomain.com",
  to: ["you@example.com"],
  subject: "Hello from Connect RPC",
  body: "Using the typed RPC client directly!",
});

curl -X POST https://api.simpleemailapi.dev/v1/v1.EmailService/SendEmail \
  -H "Authorization: Bearer sea_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "from": "onboarding@yourdomain.com",
    "to": ["you@example.com"],
    "subject": "Hello from cURL",
    "body": "It works!"
  }'

buf curl \
  --schema buf.build/simpleemailapi/public \
  --header "Authorization: Bearer sea_live_..." \
  --data '{
    "from": "onboarding@yourdomain.com",
    "to": ["you@example.com"],
    "subject": "Hello from buf curl",
    "body": "It works!"
  }' \
  https://api.simpleemailapi.dev/v1.EmailService/SendEmail

import { createClient } from 'simpleemailapi';

const client = createClient({ apiKey: 'sea_live_...' });

// Listen for events in real-time
client.onReceive({
  onDelivered: (event) => console.log('Delivered:', event),
  onReplied: (event) => console.log('Reply:', event.body),
  onBounced: (event) => console.log('Bounced:', event),
  onError: (err) => console.error(err)
});

ctx, cancel := context.WithCancel(context.Background())
defer cancel()

client.OnReceive(ctx, emailapi.EventHandlers{
    OnDelivered: func(e *v1.EmailDeliveredEvent) {
        log.Println("Delivered to:", e.Recipients)
    },
    OnReplied: func(e *v1.EmailRepliedEvent) {
        log.Println("Reply from:", e.From)
    },
    OnBounced: func(e *v1.EmailBouncedEvent) {
        log.Println("Bounced:", e.BounceType)
    },
    OnError: func(err error) {
        log.Println("Error:", err)
    },
})

import { createClient } from "@connectrpc/connect";
import { createConnectTransport } from "@connectrpc/connect-node";
import { EmailService } from "@buf/simpleemailapi_public.connectrpc_es/v1/email_connect";

const transport = createConnectTransport({
  baseUrl: "https://api.simpleemailapi.dev",
  httpVersion: "2",
  interceptors: [
    (next) => async (req) => {
      req.header.set("Authorization", "Bearer sea_live_...");
      return next(req);
    },
  ],
});

const client = createClient(EmailService, transport);

const stream = client.streamEvents({
  cursor: "0",
});

for await (const event of stream) {
  console.log("New Event:", event);
}

# Use -N to disable buffering for streaming responses
curl -N -X POST https://api.simpleemailapi.dev/v1/v1.EmailService/StreamEvents \
  -H "Authorization: Bearer sea_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "cursor": "0" }'

buf curl \
  --schema buf.build/simpleemailapi/public \
  --header "Authorization: Bearer sea_live_..." \
  --data '{ "cursor": "0" }' \
  https://api.simpleemailapi.dev/v1.EmailService/StreamEvents

import express from 'express';
import { Webhook } from 'svix';

const app = express();

app.post('/webhook', express.raw({ type: 'application/json' }), (req, res) => {
  const secret = process.env.WEBHOOK_SECRET;
  const headers = req.headers;
  const payload = req.body;

  const wh = new Webhook(secret);
  const event = wh.verify(payload, headers);

  console.log('Webhook received:', event);
  res.json({ received: true });
});

app.listen(3000);