send_bulk_sms
Sends the same SMS text to up to 500 recipients in one call. Batches over 50 are queued and return a jobId for progress tracking.
Instructions
Send the same SMS text to up to 500 recipients. Batches over 50 recipients are queued (HTTP 202) and return a jobId; use get_bulk_job to follow progress.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"to": "<to>",
"text": "<text>"
},
"name": "send_bulk_sms"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | Yes | Phone numbers in international format. | |
| from | No | Approved Sender ID (max 11 chars). Omit to use the default sender "TopSMS". | |
| text | Yes | Common message text. | |
| send_at | No | Schedule for later: ISO 8601 with timezone, e.g. 2026-10-01T09:00:00+02:00 (max 30 days ahead). Omit to send now. Scheduled sends return a jobId that can be cancelled with cancel_scheduled. | |
| idempotencyKey | No | Optional Idempotency-Key (e.g. a UUID). Repeating a call with the same key never sends the SMS twice; the original response is returned. |