Send SMS
bulksms_send_messageWRITE: SENDS REAL SMS to real people and SPENDS CREDITS from the user's BulkSMS account; it cannot be undone or recalled. One message text to 1 to 10 phone numbers in international format (e.g. +447700900000). Cost = credits per message part x number of parts x number of recipients (about 1 credit per 160-character GSM part to a standard-route destination; the exact cost depends on the destination and appears as creditCost on the sent messages afterwards). Messages longer than one part are concatenated up to max_parts parts (default 3). Non-GSM characters (emoji, accents outside GSM 03.38) are replaced by "?" unless auto_unicode is true, which sends Unicode (shorter parts, more credits). Messages to blocked numbers still cost credits. Only send what the user explicitly asked for, confirm the text and recipients first. No groups, no scheduling. Texts containing BulkSMS template placeholders such as {F0###}, {fn###} or {sn###} are rejected (they would merge contact data). BulkSMS REST: POST /messages.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | Yes | 1 to 10 recipient numbers in international format with country code, e.g. +447700900000 or 27831234567. | |
| body | Yes | The message text. | |
| from | No | Optional sender id: an allowed international number or a short alphanumeric name (see get_profile originAddresses). Omit to use the account default. | |
| max_parts | No | Cap on concatenated parts (and so on cost per recipient). Default 3. | |
| auto_unicode | No | If true, a text with characters outside GSM 03.38 is sent as Unicode instead of having them replaced by '?'. Default false. | |
| user_supplied_id | No | Your own reference (max 20 characters) stored on the messages, usable as a filter in list_messages. |