> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ouraicalling.com/llms.txt
> Use this file to discover all available pages before exploring further.

# SMS

> Send outbound SMS from workspace phone numbers

Send outbound SMS from a phone number that belongs to your workspace and has **Allow outbound SMS** enabled.

## Who can send

| Number source                        | Requirements                                                                                     | Billing                                                                 |
| ------------------------------------ | ------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------- |
| Marketplace (bought on the platform) | `sms_capable` + outbound SMS enabled                                                             | Platform SMS credits **including** carrier pass-through                 |
| Twilio import (BYOC)                 | Twilio carrier connection, `sms_capable`, outbound SMS enabled, A2P registered for US 10DLC → US | Platform SMS credits only (you pay Twilio carrier cost on your account) |

## Enable outbound SMS

1. Open **Settings → Numbers** and select the number.
2. Open the **SMS** tab (visible when the number is SMS-capable).
3. Enable **Allow outbound SMS**.
4. For US 10DLC numbers, complete A2P 10DLC registration in your Twilio account and wait until the number is linked to an approved campaign.

## API

```bash theme={null}
curl -X POST "https://{domain}/api/v1/sms/send" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from_number_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "to": "+14155550100",
    "body": "Hello from the platform"
  }'
```

**Required scope:** `phone_numbers:write`

See also: OpenAPI `POST /sms/send`, MCP tool `send_sms`.