Tone: Send SMS

Send an SMS message via Tone

Tone: Send SMS

AI-generated

Summary

Sends an SMS through the Tone API by POSTing to /v1/sms/send once for each input item, and returns Tone's response for each message.

Inputs

  • to (required) — Recipient phone number in E.164 format, e.g. +919876543210. Can be set with an expression to use a different number per item.
  • from (required) — Your provisioned Tone sender number in E.164 format, e.g. +918035001234.
  • body (required) — SMS text. The UI says the maximum is 1600 characters. The node sends it to the API as the message field and doesn't check the length itself.

Output shape

One output item per input item. Each item's json is the parsed JSON response from the Tone API, and it is paired to its input item.

The response fields depend on the Tone API, and the source doesn't define them. Authentication uses the required toneApi credential: its apiKey is sent as a Bearer token and its baseUrl is the API host. If a request fails and 'Continue On Fail' is enabled, that item's output is { error: <message> }. If 'Continue On Fail' is off, the node throws a NodeOperationError for the failing item and stops the run. Messages are sent one at a time, so earlier ones may already have been sent when a later one fails.

Examples

Example 1: Send a fixed alert to one phone number

To: +919876543210, From: your Tone number, Message: 'Deployment finished successfully.'

Example 2: Send a personalised SMS to each row from a spreadsheet or database node

To: {{$json.phone}}, From: your Tone number, Message: 'Hi {{$json.name}}, your order {{$json.orderId}} has shipped.' Enable Continue On Fail to keep going if a number is rejected.

Links

Discussion