# draft_sms

> Draft an SMS text message for the user to review and send.

<!-- Source: https://docs.actuallycare.com/tools/communication/draft_sms -->

Draft an SMS text message for the user to review and send. Use this when the user asks you to text, message, or send an SMS to a contact or lead. The message will appear as an interactive card in the chat where the user can review, edit, and send it via Twilio.

> [!IMPORTANT]
> SMS messages should be concise (under 160 characters for a single segment). Always look up the recipient's phone number first using [`contacts_list`](/tools/contacts/contacts_list) or [`leads_list`](/tools/leads/leads_list). The recipient must have active SMS consent on file before sending.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `to` | string | Yes | Recipient phone number. Look up via [`contacts_list`](/tools/contacts/contacts_list) or [`leads_list`](/tools/leads/leads_list) first. Format: (555) 123-4567 or 5551234567. · Format: Phone number |
| `body` | string | Yes | SMS message body. Keep concise — 160 chars = 1 segment. Over 160 splits into multiple segments which cost more. · Max length: 1600 |
| `contact_id` | string | No | UUID of the contact being texted. Required for consent verification and CRM tracking. · Format: UUID |
| `related_entity_type` | enum | No | Type of related entity if this text is about a specific transaction or listing. · One of: `escrow`, `listing`, `appointment`, `deal` |
| `related_entity_id` | string | No | UUID of the related entity (escrow, listing, etc.). · Format: UUID |

## Example prompts

- "Text Marcus Lee a quick reminder about tomorrow's 10am walkthrough at 67 Maple Ct."
- "Draft a short text to the Hendersons letting them know their offer was accepted."

## Safety

**Draft only.** Prepares a draft for your review — nothing is sent until you approve it.