> For a complete index of all SignalWire documentation pages, fetch https://signalwire.com/docs/llms.txt

# send_sms

> Send an outbound message to a PSTN phone number.

Send an outbound message to a PSTN phone number.

## **Properties**

An object that accepts the following properties. Supports both SMS and MMS messages. See [message types](#message-types) below for the properties specific to each type.

## **Message types**

The `send_sms` object accepts the following properties depending on the message type:

Phone number to send SMS message to in e.164 format

Phone number SMS message will be sent from

Body of the text message

Region of the world to originate the message from

Array of tags to associate with the message to facilitate log searches

Phone number to send SMS message to in e.164 format

Phone number SMS message will be sent from

Array of media URLs to include in the message

Optional text to accompany the media

Region of the world to originate the message from

Array of tags to associate with the message to facilitate log searches

## **Variables**

Set by the method:

* **send\_sms\_result:** (out) `success` | `failed`.

## **Examples**

Send a text-only message:

```yaml
version: 1.0.0
sections:
  main:
    - send_sms:
        from_number: "+155512312345"
        to_number: "+15555554321"
        body: "Hi, I hope you're well."
```

```json
{
  "version": "1.0.0",
  "sections": {
    "main": [
      {
        "send_sms": {
          "from_number": "+155512312345",
          "to_number": "+15555554321",
          "body": "Hi, I hope you're well."
        }
      }
    ]
  }
}
```

Send a message with media attachment:

```yaml
version: 1.0.0
sections:
  main:
    - send_sms:
        from_number: "+155512312345"
        to_number: "+15555554321"
        media: ["https://example.com/image.jpg"]
        body: "Check out this image!"
```

```json
{
  "version": "1.0.0",
  "sections": {
    "main": [
      {
        "send_sms": {
          "from_number": "+155512312345",
          "to_number": "+15555554321",
          "media": [
            "https://example.com/image.jpg"
          ],
          "body": "Check out this image!"
        }
      }
    ]
  }
}
```