---
title: Send SMS
description: "Send an SMS from a real SIM to any number, with an optional delivery report, or pair it with Wait SMS to verify the full delivery path."
lastUpdated: "2026-09-23"
---

> **For AI agents:** the complete documentation index is at [llms.txt](/llms.txt). Append `.md` to any page URL for its markdown version.

Send an SMS from the SIM to any number. Pair it with a [Wait SMS](/tests/actions/cellular/wait-sms) on a second SIM to verify the full delivery path, or enable the delivery report to check the network's acknowledgment.

## Parameters

| Parameter | Required | Description |
| ----------- | ---------- | ------------- |
| Access technology | No | Network technology to use. Default: automatic. |
| Recipient Number | Yes | The destination phone number. Supports variables. |
| Message | Yes | The SMS body. Long texts are sent as multi-part SMS. |
| Wait for delivery | No | Wait for the network delivery report, with a timeout in seconds. Default: off, 10s. |
| Change default SMSC | No | Send through a specific SMS service center. |
| Execute multiple times | No | Repeat the send 1 to 30 times. |
| SMS should fail | No | Invert the verdict: the action succeeds only if the send fails (barring tests, for example). |

## Results and metrics

In the action report (`result`):

| Field | Description |
|-------|-------------|
| `duration` | Time to send, in seconds. |
| `result` | Send outcome from the network. |
| `part_count` | Number of SMS parts sent. |
| `retries_count` | Retries needed before the send succeeded. |
| `smsc` | The SMS service center used. |
| `sms_delivery_report` | When enabled: delivery status and time to delivery. |

In Analytics, each run feeds the SMS send measurement with `duration_seconds`, tagged by status, SMSC, antenna, and access technology. When the delivery report is enabled, its status is tagged too.

## What's next?

<Columns cols={2}>
  <Card title="Wait SMS" icon="envelope" href="/tests/actions/cellular/wait-sms">

    Verify reception on the destination SIM

</Card>
  <Card title="Place Call" icon="phone" href="/tests/actions/cellular/place-call">

    The same two-SIM pattern for voice

</Card>
</Columns>