SMSPreferenceHandlerSNC - Scoped, Global

concept brazil Updated Sep 10, 2026 1 min read SMSPreferenceHandlerAPI.md

The SMSPreferenceHandler script include provides methods to manage short message service (SMS) configurations.

This script include is implemented as the script include SMSPreferenceHandlerSNC and resides in the sn_sms_pref namespace. To use this API you must install the Notify plugin (com.snc.notify) which requires a separate subscription. You can activate this plugin if you have the admin role.

Parent Topic:Server API reference

SMSPreferenceHandlerSNC - SMSPreferenceHandler(String provider)

Instantiates the SMSPreferenceHandler script include object.

Name	Type	Description
provider	String	Name of the telephony service provider.

JavaScript

var handler = new sn_sms_pref.SMSPreferenceHandler('TwilioDirect'); // Pass the provider namevar config = handler.getConfig();

SMSPreferenceHandlerSNC - getConfig()

Returns the preferences configuration record for the current telephony service provider.

The method queries all preference configuration records from the SMS Preference Configuration [sn_sms_pref_configuration] table for the current telephony service provider, sorts the results by the Order field (lowest to highest), and then returns the first record.

Name	Type	Description
None

Type	Description
GlideRecord	Preference configuration record for the current telephony service provider. If no record exists, then null.

JavaScript

var handler = new sn_sms_pref.SMSPreferenceHandler('TwilioDirect'); // Pass the provider namevar config = handler.getConfig();

55 lines · 2.4 KB Wrap lines

---
title: SMSPreferenceHandlerSNC - Scoped, Global
description: The SMSPreferenceHandler script include provides methods to manage short message service \(SMS\) configurations.Instantiates the SMSPreferenceHandler script include object.Returns the preferences configuration record for the current telephony service provider.
locale: en-US
canonical_url: https://www.servicenow.com/docs/r/api-reference/server-api-reference/SMSPreferenceHandlerAPI.html
release: brazil
product: Server API Reference
classification: server-api-reference
topic_type: concept
last_updated: "2026-09-10"
reading_time_minutes: 1
breadcrumb: [Server API reference, API reference, API implementation and reference]
---

# SMSPreferenceHandlerSNC - Scoped, Global

The SMSPreferenceHandler script include provides methods to manage short message service \(SMS\) configurations.

This script include is implemented as the script include SMSPreferenceHandlerSNC and resides in the `sn_sms_pref` namespace. To use this API you must install the Notify plugin \(com.snc.notify\) which requires a separate subscription. You can activate this plugin if you have the admin role.

**Parent Topic:**[Server API reference](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/api-reference/server-api-reference/api-server.md)

## SMSPreferenceHandlerSNC - SMSPreferenceHandler\(String provider\)

Instantiates the SMSPreferenceHandler script include object.

|Name|Type|Description|
|----|----|-----------|
|provider|String|Name of the telephony service provider.|

```
var handler = new sn_sms_pref.SMSPreferenceHandler('TwilioDirect'); // Pass the provider name
var config = handler.getConfig();
```

## SMSPreferenceHandlerSNC - getConfig\(\)

Returns the preferences configuration record for the current telephony service provider.

The method queries all preference configuration records from the SMS Preference Configuration \[sn\_sms\_pref\_configuration\] table for the current telephony service provider, sorts the results by the Order field \(lowest to highest\), and then returns the first record.

|Name|Type|Description|
|----|----|-----------|
|None| | |

|Type|Description|
|----|-----------|
|GlideRecord|Preference configuration record for the current telephony service provider. If no record exists, then null.|

```
var handler = new sn_sms_pref.SMSPreferenceHandler('TwilioDirect'); // Pass the provider name
var config = handler.getConfig();
```