Documentation Index
Fetch the complete documentation index at: /docs/llms.txt
Use this file to discover all available pages before exploring further.
Send email and SMS from TypeScript with torpedo-sdk
pnpm add torpedo-sdk
import { Torpedo } from 'torpedo-sdk'
const torpedo = new Torpedo({
apiKey: process.env.TORPEDO_API_KEY!,
})
await torpedo.emails.send({
from: 'Acme <hello@myapp.com>',
to: 'user@example.com',
subject: 'Welcome to Acme',
html: '<h1>Welcome!</h1><p>Thanks for signing up.</p>',
})
html,
generates plain text, and sends the existing Torpedo email API request.
React Email support is optional. Install it only when you want to send React templates:
pnpm add react react-dom @react-email/components @react-email/render
import { Body, Html, Text } from '@react-email/components'
import { Torpedo } from 'torpedo-sdk'
function WelcomeEmail({ name }: { name: string }) {
return (
<Html>
<Body>
<Text>Welcome {name}</Text>
</Body>
</Html>
)
}
const torpedo = new Torpedo({
apiKey: process.env.TORPEDO_API_KEY!,
})
await torpedo.emails.send({
from: 'Acme <hello@myapp.com>',
to: 'user@example.com',
subject: 'Welcome to Acme',
template: <WelcomeEmail name="Eliot" />,
})
text if you want full control over the plain-text part:
await torpedo.emails.send({
from: 'Acme <hello@myapp.com>',
to: 'user@example.com',
subject: 'Welcome to Acme',
template: <WelcomeEmail name="Eliot" />,
text: 'Welcome Eliot',
})
await torpedo.emails.sendBatch({
emails: [
{
from: 'Acme <hello@myapp.com>',
to: 'one@example.com',
subject: 'Welcome',
html: '<h1>Welcome!</h1>',
},
{
from: 'Acme <hello@myapp.com>',
to: 'two@example.com',
subject: 'Welcome',
template: <WelcomeEmail name="Eliot" />,
},
],
})
await torpedo.emails.sendBatch({
idempotencyKey: 'customer-import-2026-07-31',
emails,
})
await torpedo.sms.send({
to: '+258841234567',
body: 'Your verification code is 482910.',
})
idempotencyKey to email and SMS send inputs.
const emails = await torpedo.emails.list({ limit: 20 })
const email = await torpedo.emails.get(emails.data[0].id)
const smsMessages = await torpedo.sms.list({ limit: 20 })
const sms = await torpedo.sms.get(smsMessages.data[0].id)