---
isPublished: true
knowledgeIndex: false
hidden: true
noindex: true
template: "page.peb"
title: "SMS Text Action Flow Reference"
description: "Request delivery of an SMS message."
contentType: "reference"
audience: "admin,developer"
---

# SMS Text Action

Request delivery of an SMS message.
The namespaced Apex action name is `rooms__SMSTextAction`.

## Transaction summary

| Effect | Behavior |
| --- | --- |
| API callout | Yes. The action waits for the SMS submission response. |
| Record writes | No ordinary record write in the action step. An unsuccessful SMS response can create an DialogueOne Event record. The immediate action does not confirm later reply handling. |
| Platform event | The action does not directly publish a platform event. |
| Background work | The immediate response does not confirm delivery to the recipient's device. |
| Email | Sends SMS rather than email. |

## Inputs

Required describes the Flow input setting. Additional configuration rules can still require a value.

| API name | Flow label | Required | Default or guidance |
| --- | --- | --- | --- |
| `phoneTo` | Phone Number (To number) | No | Supply the destination in international phone format, including country code. Contact or Lead context does not replace this value. |
| `dialogueId` | Dialogue ID | No | Optional dialogue context for later message handling. |
| `leadId` | Lead ID (To) | No | Exposed input. This action does not forward it as Lead context. |
| `contactId` | Contact ID (To) | No | Optional Contact context for message status handling. |
| `userId` | User ID (From) | No | Optional sending-user context. |
| `recordId` | Record ID | No | Optional related Salesforce record. |
| `messageBody` | Message Body | No | Supply the SMS message body, up to 1,600 characters. |
| `autoResponse` | Auto Response (to any replies) | No | Optional response text for incoming replies. |
| `twilioAccountSID` | Twilio Account SID | No | Optional messaging-account identifier. Use the configured account when no override is required. |
| `twilioAuthToken` | Twilio Auth Token | No | Optional account credential override. Use protected configuration; do not place a credential in public examples. |
| `twilioPhoneNumber` | Twilio Phone Number (From number) | No | Optional sending phone number for the messaging account. |

## Outputs

| API name | Flow label | Meaning |
| --- | --- | --- |
| `phoneTo` | Phone Number | Exposed output. It is not populated by this action; retain the input value. |
| `messageBody` | Message Body | Exposed output. It is not populated by this action; retain the input value. |
| `success` | Success | Whether the SMS submission received a successful response. It is not device-delivery confirmation. |
| `message` | Message | Submission acknowledgement, message reference or error details. |

## Configure the Flow

1. Set the destination phone number and message body.
2. Use the configured messaging account or approved overrides.
3. Set optional record and Contact context for later status handling.
4. Store Success and Message, and connect the Fault path.
5. Check the message result before retrying an uncertain submission.

Confirm the Flow user's Apex action access and access to the records or Files used by this operation. Review the configured Salesforce API connection user's access when the action makes an API request.

## Troubleshooting

**You have uncommitted work pending.** This action makes a callout. An error can also write an DialogueOne Event before later Flow work.

**Contact or Lead is selected but no SMS is sent.** Supply Phone Number and Message Body. Contact context does not resolve the destination phone in this action, and Lead ID is not forwarded.

**Delivery is uncertain.** Check the message status and DialogueOne Events before resending. A repeated request can send another SMS.

See the [Flow action catalog](/content/build/flows/index.md) for related actions and transaction guidance. Confirm that the action and input fields are available in the installed package.
