Send SMS
send_smsSend an SMS to one or more phone numbers or short codes through your own textbee account and Android phone, with optional scheduling and SIM selection.
Instructions
Send an SMS through the user's own textbee account and Android phone. Recipients are phone numbers or short codes, sent as the user gives them. A local number or short code reaches recipients in the sending phone's country. For a number in another country, use international format with the country code, such as +15550100123. Sender names such as MYBANK cannot receive SMS. The sending phone is chosen automatically: the account default device, otherwise the enabled device with the most recent heartbeat. Only pass device_id when the user explicitly names a phone; ids come from list_devices. Sending costs the user a real message against their textbee plan quota, so do not send speculatively and do not retry a send that may already have gone out. When the account has SMS queueing enabled the result includes an sms_batch_id; pass it to get_messages as sms_batch_id to check per-recipient delivery status.
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": {
"message": "<message>",
"recipients": "<recipients>"
},
"name": "send_sms"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| message | Yes | The SMS body, plain text. Long messages are split into segments by the carrier and each segment counts against the quota; the result reports the segment count. | |
| device_id | No | Which registered phone sends the message. Omit in almost every case and let textbee choose. Pass it only when the user asks for a specific phone. Ids come from list_devices. | |
| recipients | Yes | Phone numbers or short codes, as the user gives them, for example ["5550100123"] or ["+15550100123"]. Do not add a country code or ask for one when the user gives a local number. Each recipient counts as one message. The plan caps how many recipients one send may have; the server rejects the send beyond it. | |
| sim_number | No | Which SIM sends the message: 1 for SIM 1, 2 for SIM 2. Omit to use the phone's default SIM. | |
| scheduled_at | No | ISO 8601 timestamp to send later instead of now, for example 2026-09-01T14:30:00Z. Must be in the future, and requires the account's server to have queueing enabled. Omit to send immediately. | |
| sim_subscription_id | No | Older option. The Android id of a SIM. It can change after a SIM swap, and a wrong value is silently ignored. Prefer sim_number. If both are given, only sim_number is used. |