# SMS

*Settings → sms* connects SAS Radius to your SMS provider and sets the SMS texts. SAS Radius works with any provider that offers an HTTP API.

[![settings sms](https://help.snono-systems.com/uploads/images/gallery/2026-11/scaled-1680-/settings-sms.png)](https://help.snono-systems.com/uploads/images/gallery/2026-11/settings-sms.png)

<table id="bkmrk-fielddescription-ena"><thead><tr><th>Field</th><th>Description</th></tr></thead><tbody><tr><td>Enable SMS Service</td><td>Turns SMS sending on. Required for every SMS, including activation, expiration and FUP messages.</td></tr><tr><td>SMS API Url</td><td>The address of your provider's send API. Use <code>&#123;dst&#125;</code> for the phone number and <code>&#123;text&#125;</code> for the message, for example <code>https&#58;&#47;&#47;sms&#46;example&#46;com&#47;send&#63;user&#61;X&#38;pass&#61;Y&#38;to&#61;&#123;dst&#125;&#38;msg&#61;&#123;text&#125;</code>.</td></tr><tr><td>API Method</td><td>**GET** or **POST**: the HTTP method your provider expects. Both send the SMS.</td></tr><tr><td>POST Parameters</td><td>Shown for POST. The form fields sent to the provider as name = value pairs, for example <code>phone &#61; &#123;dst&#125;</code>, <code>message &#61; &#123;text&#125;</code>, plus any account fields your provider needs.</td></tr><tr><td>Activation SMS</td><td>Sent after the service is activated (needs *Notify via SMS on activation* in [Notifications](https://help.snono-systems.com/books/sas-radius/page/notifications)).</td></tr><tr><td>SMS to be sent before expiration</td><td>Sent a few days before the subscription expires (needs *Notify via SMS on expiration*; the number of days is set there).</td></tr><tr><td>SMS to be sent after expiration</td><td>Sent at the moment the subscription expires.</td></tr></tbody></table>

## Placeholders

These words in the message are replaced with the subscriber's data:

<table id="bkmrk-messageplaceholders-"><thead><tr><th>Message</th><th>Placeholders</th></tr></thead><tbody><tr><td>Activation SMS</td><td>{username}, {firstname}, {lastname}, {exp} (expiration), {srv} (profile), {balance}, {id}, {parent\_name}, {parent\_phone}, {parent\_address}</td></tr><tr><td>SMS before expiration</td><td>{username}, {firstname}, {lastname}, {exp}, {srv}</td></tr><tr><td>SMS after expiration</td><td>{username}, {firstname}, {lastname}, {exp}, {srv}, {parent\_name}, {parent\_phone}, {parent\_address}</td></tr></tbody></table>

## Buttons

- **Test**: enter a mobile number to queue a test message. *Success* means it was queued, not delivered; check the phone.
- **Reset**: reloads the saved values.

## Notes

- The user needs a phone number in the user form.
- SMS are sent by the **SMS Service** (*Tools → System Services*). If SMS don't go out after changing the settings, restart that service.
- Test the API URL in a browser first (with a real number and text) to make sure your provider accepts it.

*Required permission: Settings - System Settings*