Quickstart

1. Create your account and API key

Sign up for Torpedo, create a workspace, and create an API key from the dashboard. Copy the key when it is shown—it is returned once only and cannot be recovered. Store the key as TORPEDO_API_KEY in your application’s server-side secret storage. Never put it in browser code, a mobile application, source control, logs, or an MCP request.

2. Add a domain

curl -X POST https://api.torpedo.co.mz/api/v1/domains \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "domain": "myapp.com" }'

const res = await fetch('https://api.torpedo.co.mz/api/v1/domains', {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.TORPEDO_API_KEY,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ domain: 'myapp.com' }),
})
const { data } = await res.json()
// data.dns contains the DNS records to add

The response includes DNS records. Add all of them to your DNS provider:

Type	Name	Value
CNAME	`torpedo1._domainkey.myapp.com`	`torpedo1.dkim.amazonses.com`
CNAME	`torpedo2._domainkey.myapp.com`	`torpedo2.dkim.amazonses.com`
CNAME	`torpedo3._domainkey.myapp.com`	`torpedo3.dkim.amazonses.com`
TXT	`myapp.com`	`v=spf1 include:amazonses.com ~all`
TXT	`_dmarc.myapp.com`	`v=DMARC1; p=none;`

DNS propagation can take a few minutes to a few hours depending on your provider’s TTL settings.

3. Verify the domain

Once DNS has propagated, trigger a verification check:

curl -X POST https://api.torpedo.co.mz/api/v1/domains/DOMAIN_ID/verification-checks \
  -H "X-API-Key: YOUR_API_KEY"

const res = await fetch(
  `https://api.torpedo.co.mz/api/v1/domains/${domainId}/verification-checks`,
  {
    method: 'POST',
    headers: { 'X-API-Key': process.env.TORPEDO_API_KEY },
  }
)
const { data } = await res.json()
console.log(data.status) // 'verified' when DNS is set up correctly

4. Send your first email

curl -X POST https://api.torpedo.co.mz/api/v1/emails \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "Acme <hello@myapp.com>",
    "to": "user@example.com",
    "subject": "Welcome to Acme",
    "html": "<h1>Welcome!</h1><p>Thanks for signing up.</p>",
    "text": "Welcome! Thanks for signing up."
  }'

const res = await fetch('https://api.torpedo.co.mz/api/v1/emails', {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.TORPEDO_API_KEY,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    from: 'Acme <hello@myapp.com>',
    to: 'user@example.com',
    subject: 'Welcome to Acme',
    html: '<h1>Welcome!</h1><p>Thanks for signing up.</p>',
    text: 'Welcome! Thanks for signing up.',
  }),
})
const { data } = await res.json()
console.log(data.id) // email ID
console.log(data.status) // 'queued'

import httpx

res = httpx.post(
    'https://api.torpedo.co.mz/api/v1/emails',
    headers={'X-API-Key': TORPEDO_API_KEY},
    json={
        'from': 'Acme <hello@myapp.com>',
        'to': 'user@example.com',
        'subject': 'Welcome to Acme',
        'html': '<h1>Welcome!</h1><p>Thanks for signing up.</p>',
        'text': 'Welcome! Thanks for signing up.',
    },
)
data = res.json()['data']
print(data['id'], data['status'])  # queued

The response is 202 Accepted — email is queued and will be delivered asynchronously.

You’ve sent your first email with Torpedo.

Verify a phone number

The same API key can send one-time codes over WhatsApp. No domain is needed for this:

curl -X POST https://api.torpedo.co.mz/api/v1/verify \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "to": "+258841234567" }'

Then check the code the user types with POST /api/v1/verify/{id}/check. You need a WhatsApp balance first; see Verify phone numbers on WhatsApp.

Next steps

Verify phone numbers

Send WhatsApp one-time codes with SMS fallback

Set up webhooks

Get notified on delivery, bounces, and complaints

Manage suppressions

Understand and manage the suppression list

Getting started

SDKs

Email

SMS

WhatsApp

1. Create your account and API key

2. Add a domain

3. Verify the domain

4. Send your first email

Verify a phone number

Next steps

Verify phone numbers

Set up webhooks

Manage suppressions

​1. Create your account and API key

​2. Add a domain

​3. Verify the domain

​4. Send your first email

​Verify a phone number

​Next steps

Verify phone numbers

Set up webhooks

Manage suppressions

1. Create your account and API key

2. Add a domain

3. Verify the domain

4. Send your first email

Verify a phone number

Next steps