Skip to main content

Requirements

  • An active paid plan and SMS credits
  • SMS credits in your workspace (purchase from the billing page)
  • SMPP must be enabled on your Torpedo instance

Basic send

The response is 202 Accepted — delivery is asynchronous.

Phone number format

The to field must be a valid Mozambican mobile number in E.164 format:
Accepted prefixes: 84, 82, 83, 85, 86, 87 (Vodacom, Movitel, tmcel).

SMS status lifecycle

Poll GET /api/v1/sms/{id} to check the current status.

Idempotency

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

Credits and quota

Each SMS deducts one credit from your workspace balance. If your balance reaches zero, sends return 402:
Purchase additional credits from the billing page in your dashboard.

Suppression

Addresses that permanently fail delivery (UNDELIV, REJECTD SMPP error codes) are automatically added to the suppression list. Sending to a suppressed number returns 422:
Remove an address from the suppression list via DELETE /api/v1/suppressions/{address}?channel=sms.