Node / TypeScript SDK

npm install pristinesend
# optional — only if you use the react: convenience
npm install @react"color:#ff7b72">-email/render react

"color:#ff7b72">import { PristineSend } "color:#ff7b72">from "pristinesend"

"color:#ff7b72">const ps = "color:#ff7b72">new PristineSend(process.env.PRISTINESEND_API_KEY!) // ps_live_… or ps_test_…

// Options:
"color:#ff7b72">const client = "color:#ff7b72">new PristineSend({
  apiKey: process.env.PRISTINESEND_API_KEY!,
  maxRetries: 4,   // default 2
  timeout: 30_000, // ms, default 60000
})

"color:#ff7b72">const { id } = "color:#ff7b72">await ps.emails.send({
  to: "customer@example.com",
  "color:#ff7b72">from: "you@yourdomain.com", // omit to use your workspace default sender
  subject: "Welcome!",
  html: "<h1>Hello</h1>",
})

// Batch (up to 100) — partial success, one bad recipient never fails the rest:
"color:#ff7b72">const batch = "color:#ff7b72">await ps.emails.sendBatch({
  emails: [
    { to: "a@example.com", subject: "Hi", html: "<p>1</p>" },
    { to: "b@example.com", subject: "Hi", html: "<p>2</p>" },
  ],
})
console.log(batch.summary) // { total, sent, failed }

// An Idempotency-Key is sent automatically (auto-generated unless you pass one),
// so a network retry never double-sends — the server replays the original result.
"color:#ff7b72">await ps.emails.send({ to, subject, html, idempotencyKey: "order-1234-receipt" })

"color:#ff7b72">import { WelcomeEmail } "color:#ff7b72">from "./emails/welcome"

"color:#ff7b72">await ps.emails.send({
  to: "customer@example.com",
  subject: "Welcome!",
  react: <WelcomeEmail name="Sam" />, // rendered to html via @react-email/render
})

// The returned page is "color:#ff7b72">async-iterable and fetches the next page on demand:
for "color:#ff7b72">await ("color:#ff7b72">const contact of "color:#ff7b72">await ps.contacts.list({ limit: 100 })) {
  console.log(contact.email)
}

// Or one page at a time:
"color:#ff7b72">const page = "color:#ff7b72">await ps.contacts.list()
console.log(page.data, page.has_more, page.next_cursor)
"color:#ff7b72">const next = "color:#ff7b72">await page.nextPage()

"color:#ff7b72">import { PristineSendError, RateLimitError } "color:#ff7b72">from "pristinesend"

try {
  "color:#ff7b72">await ps.emails.send({ to, subject, html })
} catch (err) {
  if (err instanceof RateLimitError) {
    console.log("retry after", err.retryAfter, "seconds")
  } else if (err instanceof PristineSendError) {
    console.error(err.code, err.message, "request:", err.requestId)
  }
}