Skip to main content
POST
Send SMS

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
to
string
required

Recipient phone number in E.164 format (Mozambican numbers only)

Pattern: ^\+2588[234567]\d{7}$
Example:

"+258841234567"

body
string
required

Message text

Required string length: 1 - 1600
Example:

"Your verification code is 482910. Expires in 10 minutes."

from
string

Sender ID the recipient sees. Omit it to use your workspace's default sender ID, or the platform sender if you have none. When set, it must exactly match a sender ID approved for your workspace; matching is case-sensitive. Anything else returns 422.

Maximum string length: 20
Example:

"AcmePay"

Response

Message queued

data
object