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.

Next steps

Set up webhooks

Get notified on delivery, bounces, and complaints

Manage suppressions

Understand and manage the suppression list

Getting started

SDKs

Email

SMS

1. Create your account and API key

2. Add a domain

3. Verify the domain

4. Send your first email

Next steps

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

​Next steps

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

Next steps