Skip to main content

Basic send

Response:
The response is 202 Accepted — delivery is asynchronous.

The from field

Accepts two formats:
The domain (myapp.com) must be verified in your workspace. If you use a domain-scoped API key, the from domain must also match the key’s domain. For best deliverability and trust, prefer a monitored sender like hello@ or support@ instead of no-reply@ whenever possible.

html and text

Provide html, text, or both. If you send only html, Torpedo generates a plain-text version automatically. Plain text is useful for:
  • Email clients that don’t render HTML
  • Spam filters that check text vs HTML ratio
  • Accessibility tools
If you want full control over the plain-text part, provide text explicitly:
To send an HTML-only email without a text part, set text to an empty string.

Email status lifecycle

Poll GET /api/v1/emails/{id} to check status, or use webhooks for real-time updates.

Idempotency

Pass an Idempotency-Key header to prevent duplicate sends if your request is retried:
If a request with the same key was already accepted, Torpedo returns the original 202 response without sending again. Keys are scoped to your workspace.

Reply-to

Set a different address for replies:

Quota limits

Sending fails with 402 if you exceed your plan’s monthly or daily quota:
Check current usage via GET /api/v1/workspace/usage.