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

# SMS Integration

> Send text message alerts via Twilio

## Overview

SMS notifications provide critical alerts directly to mobile phones, perfect for on-call rotations and urgent incidents.

***

## Setup Guide

<Steps>
  <Step title="Sign Up for Twilio">
    1. Create account at [https://twilio.com](https://twilio.com)
    2. Purchase phone number
    3. Get Account SID and Auth Token
  </Step>

  <Step title="Configure Twilio in StatusStack">
    **Settings** → **Integrations** → **Twilio**

    ```yaml theme={null}
    Account SID: AC...
    Auth Token: ***
    From Number: +1-555-123-4567
    ```
  </Step>

  <Step title="Add to Notification Rule">
    1. Create notification rule
    2. Select **SMS** channel
    3. Enter phone numbers (with country code)
    4. Set character limit
  </Step>

  <Step title="Test">
    Send test SMS
  </Step>
</Steps>

***

## Phone Number Format

**Include country code:**

```
US: +1-555-123-4567
UK: +44-20-1234-5678
International: +[country]-[number]
```

***

## Message Format

SMS messages are concise:

```
StatusStack Alert:
Production API is DOWN
Status: Critical
View: https://stst.co/p/abc123
```

**Character limit:** 160 characters (standard SMS)

***

## Cost Considerations

<Warning>
  **SMS charges apply** via Twilio

  * \~$0.0075 - $0.02 per SMS (US)
  * Higher rates internationally
  * Check Twilio pricing
</Warning>

**Best practices:**

* Use SMS for critical alerts only
* Don't send info/degraded alerts via SMS
* Consider per-alert cost in high-traffic scenarios

***

## Best Practices

* **Critical only:** Reserve for production outages
* **On-call rotation:** Integrate with PagerDuty
* **Multiple recipients:** Use escalation policies
* **Test regularly:** Verify phone numbers are current

***

## Next Steps

<CardGroup cols={2}>
  <Card title="Webhooks" icon="webhook" href="/integrations/webhooks">
    PagerDuty integration
  </Card>

  <Card title="Email Integration" icon="envelope" href="/integrations/email">
    Email notifications
  </Card>
</CardGroup>
