Skip to main content
POST
Send email

Authorizations

X-API-Key
string
header
required

Prefix tor_ followed by a base64url-encoded random key. Create and manage API keys from the authenticated Torpedo dashboard.

Headers

Idempotency-Key
string

Unique key for replaying the original accepted response without sending again. Leading and trailing whitespace is removed; only the first 255 characters are retained.

Body

application/json

Provide at least one of html or text.

from
string
required

Sender address. Must use a verified domain. Accepts bare email or display name format.

Maximum string length: 255
Example:

"Acme <hello@myapp.com>"

to
string<email>
required
Maximum string length: 255
Example:

"user@example.com"

subject
string
required
Required string length: 1 - 255
Example:

"Welcome to Acme"

html
string

HTML body of the email. If text is omitted, Torpedo generates plain text from this field.

Maximum string length: 1000000
Example:

"<h1>Welcome!</h1><p>Thanks for signing up.</p>"

text
string

Optional plain-text body. Set to an empty string to send no text part.

Maximum string length: 100000
Example:

"Welcome! Thanks for signing up."

replyTo
string<email>

Optional reply-to address

Maximum string length: 255

Response

Email queued for delivery

data
object