Transactional SMS
Send single or multi-recipient SMS
POST
Dispatches high-priority transactional SMS to 1-10 recipients. Supports test keys (sk_test_...) and magic numbers (+233200000001 through +233200000004) for deterministic sandbox simulation without deducting wallet credits.
header
X-Api-Key<token>SMS Pro API Key (sk_live_... or sk_test_...)
Idempotency-Key?stringUnique UUID or string for idempotent dispatch protection. Guarantees that a message is only sent once within a 24-hour window.
Length
length <= 128application/json- body
to?stringSingle recipient phone number in E.164 format
recipients?array<string>Multi-recipient list (1-10 phone numbers in E.164 format)
Items
items <= 10message*stringText content of the message
senderId?stringRegistered alphanumeric Sender ID (max 11 chars)
Length
length <= 11scheduleAt?stringOptional future timestamp to schedule delivery
Format
date-timedeliveryCallbackUrl?stringWebhook URL to receive signed delivery receipts
Format
uriMessage accepted and queued for carrier delivery or simulated in sandbox
application/json- response
status?stringmessage?stringdata?curl -X POST 'https://api.smspro.com/api/v1/public/sms/send' \ -H 'Content-Type: application/json' \ -d '{ "message": "string"}'Example Response
{ "status": "string", "message": "string", "data": { "jobId": "string", "messageIds": [ "string" ], "messageId": "string", "status": "string", "segmentCount": 0, "totalUnits": 0 }}