Bulk & Campaign Messaging
Submit asynchronous bulk SMS job
POST
Submits a bulk campaign for asynchronous processing. Recipients can be supplied as an inline array of phone numbers or pre-uploaded via file. Unit credits are reserved upfront and unconsumed units are refunded if cancelled prior to dispatch.
header
X-Api-Key<token>SMS Pro API Key (sk_live_... or sk_test_...)
application/json- body
jobName?stringmessage*stringsenderId?stringLength
length <= 11recipients?array<string>fileId?stringPre-uploaded CSV or Excel file ID
Format
uuidscheduledAt?stringFormat
date-timedeliveryCallbackUrl?stringFormat
uriBulk job queued for asynchronous dispatch
application/json- response
status?stringmessage?stringdata?curl -X POST 'https://api.smspro.com/api/v1/public/sms/bulk/jobs' \ -H 'Content-Type: application/json' \ -d '{ "message": "string"}'Example Response
{ "status": "string", "message": "string", "data": { "batchId": "string", "jobName": "string", "recipientCount": 0, "status": "string", "totalUnits": 0 }}