Send an SMS to 1-10 recipients
smsmode_send_smsWRITE, SPENDS CREDIT: sends one SMS text to 1 to 10 recipients (one message each, a batch of unit messages) and texts REAL people immediately, or at send_at. Cost: every message is charged to the account at its destination's price per SMS part (GSM7: 160 characters for 1 part, 306 for 2, 459 for 3...; UNICODE: 70, 134, 201...); the accept reply returns each message's id and status (the price may only appear later on smsmode_get_message / smsmode_list_messages; total_price is given when present). A batch can partly fail: failures lists the refused numbers, which are not charged. A message is never retried: after a timeout or error, check smsmode_list_messages (ref_client) before sending again. Max 10 recipients, no campaigns or lists. Check smsmode_get_balance first. POST /sms/v1/messages.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | Yes | 1-10 recipient phone numbers in international format with country code, e.g. 33610203040 or +33610203040. | |
| from | No | Sender ID (max 11 characters; must be authorized for the account, else smsmode refuses). Default: the channel's sender. | |
| stop | No | Append the legal 'STOP' unsubscribe mention (required for marketing messages with a custom sender in France). | |
| text | Yes | The SMS text (max 1530 characters GSM7 / 670 UNICODE; longer texts are split in parts and each part is charged). | |
| send_at | No | Schedule: a future date and time yyyy-mm-ddThh:mm:ss (a time is required; at least a few minutes ahead; smsmode's local time). Omit to send now. | |
| encoding | No | GSM7 (default) or UNICODE (needed for emoji and non-Latin scripts; max 670 characters). | |
| ref_client | No | Your reference tag (3-140 characters) to find these messages later. |