---
sourceDocument: Australia API Reference
sourceDocumentLink: https://www.servicenow.com/docs/r/api-reference

 Release :

    - australia

ft:locale :

    - en-US

ft:publication_title :

    - Australia API Reference

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# Notify - Global

# Notify - Global {#ariaid-title1}

* Release version: Australia
* 
* Updated March 12, 2026
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 12 minutes to read

The Notify API allows you to interact with Notify calls and SMS
messages using scripts.

Access the global Notify class and its associated methods in the
`SNC` namespace.

## Notify - call(String notifyPhoneNumber, String toPhoneNumber, GlideRecord conferenceCall,
GlideRecord conferenceCallRecord, String userSysId, String groupSysId, GlideRecord
sourceRecord) {#ariaid-title2}

Calls the specified E.164-compliant telephone number.
In addition, this method can automatically add the specified phone number to a specified
conference call.
{#r_N-call_NotifyPhoneNumber_S_GR__table_abs_4hn_wr__entry__3}

| Name | Type | Description |
|-|-|-|
| notifyPhoneNumber | String or NotifyPhoneNumber | Notify phone number from which to make the call. When you initiate a call, the outgoing call workflow for the number group associated with this number runs. Ensure this workflow includes a join conference call activity to connect the user to the conference call. |
| toPhoneNumber | String | Phone number to call. Called numbers are added to the conference call. |
| conferenceCall | GlideRecord | Optional. If this parameter is passed in, the callers identified in the toPhoneNumber parameter are automatically joined into the conference call identified by this record. GlideRecord for the Notify Call \[notify_call\] table that identifies the conference call record. This record is automatically added to the outgoing call workflow scratchpad as the workflow.scratchpad.conference_call variable. |
| userSysId | String | Optional. Unique identifier (sys_id) of the user associated with the call. |
| groupSysId | String | Optional. Unique identifier (sys_id) of the group associated with the call. |
| sourceRecord | GlideRecord | Optional. Source record that prompted this call. |
[Table 1. Parameters]

{#r_N-call_NotifyPhoneNumber_S_GR__table_abs_4hn_wr} {#r_N-call_NotifyPhoneNumber_S_GR__table_bbs_4hn_wr__entry__2}

| Type | Description |
|-|-|
| void |   |
[Table 2. Returns]

{#r_N-call_NotifyPhoneNumber_S_GR__table_bbs_4hn_wr}  
This example illustrates how to initiate a call to another phone number.

    var from = '+14048007337';
    var to = '+31646810495';

    // set up call
    new SNC.Notify().call(from, to);

This example illustrates how to initiate a call to list of telephone numbers and
automatically join those numbers into a new conference call.

    var notify = new SNC.Notify();
    var from = '+14041234567';
    var participants = ['+31612345678', '+31623456789', '+31687654321'];

    // set up a conference call
    var conferenceCall = notify.conferenceCall();

    // set up the outbound calls for all conference call participants
    for (var i in participants) {
        var to = participants[i];
        notify.call(from, to, conferenceCall);
    }

This example illustrates how to initiate a new conference call.

    SNC.Notify.call('+15413970605', '+91406XXXXXXX', SNC.Notify.conferenceCall(), null, null, null);

This example illustrates how to initiate new a conference call using a user record.

    var sysUserGr = new GlideRecord('sys_user');
    sysUserGr.get('active conference sys id');
     
    if (conferenceGr.isValid) {
        SNC.Notify.call('+15413970605', '+91406XXXXXXX', SNC.Notify.conferenceCall(), sysUserGr.getUniqueValue(), null, null);
    }

This example illustrates how to initiate a new conference call with a user, group, and
source record.

    var sysUserGr = new GlideRecord('sys_user');
    sysUserGr.get('active sys user sys id');
     
    var sysUserGroupGr = new GlideRecord('sys_user_group');
    sysUserGroupGr.get('active sys user group sys id');
     
    var incidentGr = new GlideRecord('incident');
    incidentGr.get('incident sys_id');
     
    if (conferenceGr.isValid) {
        SNC.Notify.call('+15413970605', '+91406XXXXXXX',
            SNC.Notify.conferenceCall(),
            sysUserGr.getUniqueValue(),
            sysUserGroupGr.getUniqueValue(),
            incidentGr.getUniqueValue());
    }

### Scoped equivalent

To use the call() method in a scoped application, use the
corresponding scoped method: [NotifyScoped -
call()](https://www.servicenow.com/docs/kMUk9CUt32E7w17E0qAk2w#NotifyScoped-call_S_S_GR_GR_S_S_GR "Calls the specified E.164-compliant telephone number.").

## Notify - conferenceCall(GlideRecord sourceRecord) {#ariaid-title3}

Creates a new conference call GlideRecord.
{#r_N-conferenceCall__table_ysr_5mk_js__entry__3}

| Name | Type | Description |
|-|-|-|
| sourceRecord | GlideRecord | Optional. Record that initiated the request to create the conference call. Used to populate the source and table fields on notify_conference_call record. |
[Table 3. Parameters]

{#r_N-conferenceCall__table_ysr_5mk_js} {#r_N-conferenceCall__table_zsr_5mk_js__entry__2}

| Type | Description |
|-|-|
| GlideRecord | New Notify conference call \[notify_conference_call\] record. |
[Table 4. Returns]

{#r_N-conferenceCall__table_zsr_5mk_js}  

    var notify = new SNC.Notify();
    var from = '+14041234567';
    var participants = ['+31612345678', '+31623456789', '+31687654321'];

    // set up a conference call
    var conferenceCall = notify.conferenceCall();

    // set up the outbound calls for all conference call participants
    for (var i in participants) {
        var to = participants[i];
        notify.call(from, to, conferenceCall);
    }

### Scoped equivalent {#r_N-conferenceCall__section_wzp_1dd_1gb}

To use the conferenceCall() method in a scoped application, use the
corresponding scoped method: [NotifyScoped - conferenceCall()](https://www.servicenow.com/docs/kMUk9CUt32E7w17E0qAk2w#NotifyScoped-conferenceCall "Creates a new conference call GlideRecord.").
**Related reference**   

* [Notify - call(String notifyPhoneNumber, String toPhoneNumber, GlideRecord conferenceCall, GlideRecord conferenceCallRecord, String userSysId, String groupSysId, GlideRecord sourceRecord)](https://www.servicenow.com/docs/ccHBCs7SuOkK1Lze09WeBQ#r_N-call_NotifyPhoneNumber_S_GR "Calls the specified E.164-compliant telephone number.")

## Notify - dequeueCall(GlideRecord callRecord) {#ariaid-title4}

Resumes a call after it was put in a queue (on hold).
Use this method to resume calls that were put in a queue with the
queueCall() method.
{#r_N-dequeueCall_GlideRecord__table_sf5_ddy_js__entry__3}

| Name | Type | Description |
|-|-|-|
| callRecord | GlideRecord | A GlideRecord object on the Notify Call \[notify_call\] table with the held call you want to resume. |
[Table 5. Parameters]

{#r_N-dequeueCall_GlideRecord__table_sf5_ddy_js} {#r_N-dequeueCall_GlideRecord__table_tf5_ddy_js__entry__2}

| Type | Description |
|-|-|
| void |   |
[Table 6. Returns]

{#r_N-dequeueCall_GlideRecord__table_tf5_ddy_js}  
The following example shows how to reactivate a call that was put on hold.

    var notifyCallGr = new GlideRecord('notify_call');
    notifyCallGr.get('active participant sys id');
     
    if (notifyCallGr.isValid) {
        SNC.Notify.dequeueCall(notifyCallGr);
    }

### Scoped equivalent {#r_N-dequeueCall_GlideRecord__section_dws_mnd_1gb}

To use the dequeueCall() method in a scoped application, use the
corresponding scoped method: [NotifyScoped -
dequeueCall()](https://www.servicenow.com/docs/kMUk9CUt32E7w17E0qAk2w#NotifyScoped-dequeueCall_GR "Resumes a call after it was put in a queue (on hold).").

## Notify - forwardCall(GlideRecord call, String destination, String dtmf) {#ariaid-title5}

Forwards the specified call to a different call recipient.
{#r_N-forwardCall_GR_S_S__table_byv_vml_ts__entry__3}

| Name | Type | Description |
|-|-|-|
| call | GlideRecord or String | Notify call record or the telephony provider call ID, of the call to be forwarded. |
| destination | GlideRecord or String | Notify phone number record or an E.164-compliant phone number, of the caller to which to forward the call. |
| dtmf | String | Dual Tone - Multi Frequency (DTMF) code to send upon call connection. |
[Table 7. Parameters]

{#r_N-forwardCall_GR_S_S__table_byv_vml_ts} {#r_N-forwardCall_GR_S_S__table_cyv_vml_ts__entry__2}

| Type | Description |
|-|-|
| void |   |
[Table 8. Returns]

{#r_N-forwardCall_GR_S_S__table_cyv_vml_ts}  
The following example shows how to forward a call to another phone number.

    var callID = 'CA92374b5aa561dab476a7001db6026edc'; // Twilio Call ID
    var phoneNumber = '+91406xxxxxxx';
    var dtmfTones = null;
     
    var notifyCallGr = new GlideRecord('notify_call');
    notifyCallGr.get('active participant sys id');
     
    if (notifyCallGr.isValid) {
        SNC.Notify.forwardCall(notifyCallGr(or) callID, phoneNumber, dtmfTones)
    }

### Scoped equivalent

To use the forwardCall() method in a scoped application, use the
corresponding scoped method: [NotifyScoped -
forwardCall()](https://www.servicenow.com/docs/kMUk9CUt32E7w17E0qAk2w#NotifyScoped-forwardCall_GR_S_S "Forwards the specified call to a different call recipient.").

## Notify - getAvailableClients(String notifyNumber) {#ariaid-title6}

Returns a list of client sessions that are available to receive calls.
{#r_N-getAvailableClients_String__table_ibs_r1n_ms__entry__3}

| Name | Type | Description |
|-|-|-|
| notifyNumber | String | Valid Notify phone number. |
[Table 9. Parameters]

{#r_N-getAvailableClients_String__table_ibs_r1n_ms} {#r_N-getAvailableClients_String__table_jbs_r1n_ms__entry__2}

| Type | Description |
|-|-|
| GlideRecord | GlideRecord from the notify_client_session table for the specified phone number. Returns "0" if there are no available client sessions. |
[Table 10. Returns]

{#r_N-getAvailableClients_String__table_jbs_r1n_ms}  
The following example shows how to use the getAvailableClients() method to index into the
notify_client_session table and then iterate across all available Notify clients.

    var clientSessionGr = SNC.Notify.getAvailableClients('+185xxxxxxxx'); 
    // Here clientSessionGr is of type GlideRecord on 'notify_client_session' table.
     
    var isLoggedInUserAvailable = false;
    while (clientSessionGr.next()) {
      if (clientSessionGr.user == gs.getUserID())
        isLoggedInUserAvailable = clientSessionGr.available;
    }
    gs.info('isLoggedInUserAvailable - ' + isLoggedInUserAvailable);

### Scoped equivalent {#r_N-getAvailableClients_String__section_bgp_tk2_1gb}

To use the getAvailableClients() method in a scoped application, use the
corresponding scoped method: [NotifyScoped -
getAvailableClients()](https://www.servicenow.com/docs/kMUk9CUt32E7w17E0qAk2w#NotifyScoped-getAvailableClients_S "Returns a list of client sessions that are available to receive calls.").

## Notify - getParentCallID(GlideRecord callRecord) {#ariaid-title7}

Returns the sys_id of a specified call's parent call.
Any call started by forwarding another call, such as with the Forward
workflow activity, is considered a child of the original call. The original call is the
parent call.
{#r_N-getParentCallID_GR__table_sqs_jxn_wr__entry__3}

| Name | Type | Description |
|-|-|-|
| callRecord | GlideRecord | Record on the Notify Call \[notify_call\] table for which to return the call status. |
[Table 11. Parameters]

{#r_N-getParentCallID_GR__table_sqs_jxn_wr} {#r_N-getParentCallID_GR__table_tqs_jxn_wr__entry__2}

| Type | Description |
|-|-|
| String | Unique sys_id of the parent call record. |
[Table 12. Returns]

{#r_N-getParentCallID_GR__table_tqs_jxn_wr}  
This example shows how to obtain the parent call of the specified call.

    var callRecord = new GlideRecord('notify_call');
    callRecord.get("0f4f5863ff13310014ecffffffffff28");

    var notify = new SNC.Notify();
    var parentCallID = notify.getParentCallID(callRecord);

## Notify - getPhoneNumbers() {#ariaid-title8}

Returns all phone numbers and short codes available to Notify.
{#r_N-getPhoneNumbers__table_hsf_mwf_wr__entry__3}

| Name | Type | Description |
|-|-|-|
| None |   |   |
[Table 13. Parameters]

{#r_N-getPhoneNumbers__table_hsf_mwf_wr} {#r_N-getPhoneNumbers__table_isf_mwf_wr__entry__2}

| Type | Description |
|-|-|
| List | List of NotifyPhoneNumber objects, each object representing one phone number available to Notify. |
[Table 14. Returns]

{#r_N-getPhoneNumbers__table_isf_mwf_wr}  

    var list = SNC.Notify.getPhoneNumbers();
    for (var i = 0; i < list.size(); i++) {
        var num = list.get(i);
        gs.info(num.getNumber())
    }

### Scoped equivalent {#r_N-getPhoneNumbers__section_it5_ktc_1gb}

To use the getPhoneNumbers() method in a scoped application, use the
corresponding scoped method: [NotifyScoped -
getPhoneNumbers()](https://www.servicenow.com/docs/kMUk9CUt32E7w17E0qAk2w#NotifyScoped-getPhoneNumbers "Returns all phone numbers and short codes available to Notify.").

## Notify - getTokens(GlideRecord, record) {#ariaid-title9}

Returns client tokens for any active telephony drivers for use in WebRTC or mobile
clients.
{#r_N-getTokens_GlideRecord__table_vsx_c3n_wr__entry__3}

| Name | Type | Description |
|-|-|-|
| record | GlideRecord | GlideRecord to use to identify the Notify client, such as a group record or a user record. |
[Table 15. Parameters]

{#r_N-getTokens_GlideRecord__table_vsx_c3n_wr} {#r_N-getTokens_GlideRecord__table_wsx_c3n_wr__entry__2}

| Type | Description |
|-|-|
| String | Web RTC tokens for the supported drivers, as a JSON string with the following format: {driverName1: "token1", driverName2: "token2"}, such as "TwilioDirect":"eyJhxxxx.eyJleHAiOiIxxxx.7fejxxx_mbLxxx" |
[Table 16. Returns]

{#r_N-getTokens_GlideRecord__table_wsx_c3n_wr}  
This example shows how to obtain the client tokens for the currently logged in user.

    // get Notify client Tokens per active Notify driver for the currently logged in user
    var json = new SNC.Notify().getTokens();
     
    // Parse the JSON that was return into a tokens object
    var tokens = JSON.parse(json);

    // Log line
    gs.log('Notify client tokens for the currently logged in user');

     // iterate over the driver tokens
    for (var driver in tokens) {
     	gs.log(driver + ' Driver token: ' + tokens[driver]);
    }

This example shows how to obtain the client tokens for every Notify group.

    // instantiate Notify
    var notify = new SNC.Notify();
     
    // get all Notify Groups
    var notifyGroup = new GlideRecord("notify_group");
    notifyGroup.query();
     
    // iterate over all notify groups
    while (notifyGroup.next()) {
      // generate Notify Client tokens per active Notify Driver for this group
      var json = notify.getTokens(notifyGroup);
      var tokens = JSON.parse(json);
     
      for (var driver in tokens) {
        gs.log(gs.getMessage("Notify Client token for {0} driver and Notify Group '{1}': {2}", [driver, notifyGroup.getValue('name'), tokens[driver]]));
      }
    }

### Scoped equivalent {#r_N-getTokens_GlideRecord__section_x32_ysl_1gb}

To use the getTokens() method in a scoped application, use the
corresponding scoped method: [NotifyScoped - getTokens()](https://www.servicenow.com/docs/kMUk9CUt32E7w17E0qAk2w#NotifyScoped-getTokens_GR "Returns client tokens for any active telephony drivers for use in WebRTC or mobile clients.").

## Notify - getTokenTTL(String owner) {#ariaid-title10}

Returns the maximum amount of time that a client session stays active for a specified
telephony driver before automatically timing out.
{#Notify-getTokenTTL_S__table_mnj_xqb_zfb__entry__3}

| Name | Type | Description |
|-|-|-|
| owner | String | Name of the telephony driver for which to retrieve the session length. Valid values: * Twilio: for the old driver * TwilioDirect: for the new driver {#Notify-getTokenTTL_S__ul_ql5_vgc_1gb} |
[Table 17. Parameters]

{#Notify-getTokenTTL_S__table_mnj_xqb_zfb} {#Notify-getTokenTTL_S__table_nnj_xqb_zfb__entry__2}

| Type | Description |
|-|-|
| Integer | Maximum length of the session (in seconds). Default: 1800 seconds |
[Table 18. Returns]

{#Notify-getTokenTTL_S__table_nnj_xqb_zfb}  
The following example shows how to properly call this method and the associated response.
It also shows what is returned if an invalid driver is passed.

    var owner = "TwilioDirect";  // Valid driver
    var ttl = SNC.Notify.getTokenTTL(owner);
    gs.info("Token TTL for " + owner + " --> " + ttl);
     
    owner = "Abcxyz";  // Invalid driver
    ttl = SNC.Notify.getTokenTTL(owner);
    // For an invalid driver, we throw NoSuchNotifyDriverException saying that Abcxyzdriver is not available
    // and return the default value of TTL
    gs.info("Token TTL for " + owner + " --> " + ttl); 

### Scoped equivalent {#Notify-getTokenTTL_S__section_bgp_tk2_1gb}

To use the getTokenTTL() method in a scoped application, use the
corresponding scoped method: [NotifyScoped -
getAvailableClients()](https://www.servicenow.com/docs/kMUk9CUt32E7w17E0qAk2w#NotifyScoped-getTokenTTL_S "Returns the maximum amount of time that a client session stays active for a specified telephony driver before automatically timing out.").

## Notify - hasCapability(String notifyPhoneNumber, String capability) {#ariaid-title11}

Determines whether the specified phone number has the specified capability.
The telephony driver associated with the phone number contains a list of all of the capabilities of the phone.  
Note:  
In the base system, the Notify JS driver only has 'show_speakers' as a capability; this can be modified.
{#Notify-hasCapability_S_S__table_vsy_rdg_yfb__entry__3}

| Name | Type | Description |
|-|-|-|
| notifyPhoneNumber | String | Phone number for which to check for the specified capability. |
| capability | String | Capability to detect. The string text must be an exact match to what is in the phone. |
[Table 19. Parameters]

{#Notify-hasCapability_S_S__table_vsy_rdg_yfb} {#Notify-hasCapability_S_S__table_wsy_rdg_yfb__entry__2}

| Type | Description |
|-|-|
| Boolean | Flag that indicates whether the specified phone has the specified capability. * true: phone has the capability * false: phone does not have the capability {#Notify-hasCapability_S_S__ul_ryg_y2g_yfb} |
[Table 20. Returns]

{#Notify-hasCapability_S_S__table_wsy_rdg_yfb}  
This example shows how to check if a phone has a specific capability.

    // Each driver has a defined set of capabilities.

    var capability = 'show_speakers';
    gs.info(SNC.Notify.hasCapability('+185xxxxxxxx', capability)); // true
     
    capability = 'send_sms';
    gs.info(SNC.Notify.hasCapability('+185xxxxxxxx', capability)); // false

### Scoped equivalent {#Notify-hasCapability_S_S__section_bgp_tk2_1gb}

To use the hasCapability() method in a scoped application, use the
corresponding scoped method: [NotifyScoped -
hasCapability()](https://www.servicenow.com/docs/kMUk9CUt32E7w17E0qAk2w#NotifyScoped-hasCapabilitiy_S_S "Determines whether the specified phone number has the specified capability.").

## Notify - kick(GlideRecord participant) {#ariaid-title12}

Removes the specified caller from the current Notify conference call.
{#r_N-kick_GlideRecord__table_asm_xdx_ls__entry__3}

| Name | Type | Description |
|-|-|-|
| participant | GlideRecord | GlideRecord object containing the Notify Participant \[notify_participant\] record of the caller to remove from the conference call. |
[Table 21. Parameters]

{#r_N-kick_GlideRecord__table_asm_xdx_ls} {#r_N-kick_GlideRecord__table_bsm_xdx_ls__entry__2}

| Type | Description |
|-|-|
| void |   |
[Table 22. Returns]

{#r_N-kick_GlideRecord__table_bsm_xdx_ls}  
The following example shows how to remove a participant from a conference call.

    var notifyParticipantGr = new GlideRecord('notify_participant');
    notifyParticipantGr.get('active participant sys id');
     
    if (notifyParticipantGr.isValid) {
        SNC.Notify.kick(notifyParticipantGr);
    }

### Scoped equivalent {#r_N-kick_GlideRecord__section_myh_bfd_1gb}

To use the kick() method in a scoped application, use the corresponding
scoped method: [NotifyScoped - kick()](https://www.servicenow.com/docs/kMUk9CUt32E7w17E0qAk2w#NotifyScoped-kick_GR "Removes the specified caller from the current Notify conference call.").

## Notify - modifyCall(GlideRecord callRecord, NotifyAction notifyAction) {#ariaid-title13}

Performs one or more actions on an active Notify phone call.
Available actions that you can perform on calls include queuing or dequeueing the call,
reading text, playing audio, or forwarding the call. You can also create custom actions Call
the modifyCall() method after you have specified all the actions that you
want to apply to the specified call. Refer to the [NotifyAction](https://www.servicenow.com/docs/GKh4hbJCb0DuHydJR9_fuA#c_NotifyActionApi "The NotifyAction API allows you to define actions to send to a telephony provider.") API documentation for more information about available actions.
{#r_N-modifyCall_GR_NA__table_rrh_gzn_wr__entry__3}

| Name | Type | Description |
|-|-|-|
| callRecord | GlideRecord | Notify Call \[notify_call\] record of the call for which to apply the actions. |
| notifyAction | NotifyAction | NotifyAction object describing one or more actions to perform on the call. Create this object by calling one or more of the NotifyAction() methods. |
[Table 23. Parameters]

{#r_N-modifyCall_GR_NA__table_rrh_gzn_wr} {#r_N-modifyCall_GR_NA__table_srh_gzn_wr__entry__2}

| Type | Description |
|-|-|
| void |   |
[Table 24. Returns]

{#r_N-modifyCall_GR_NA__table_srh_gzn_wr}  
This example shows how to modify a call.

    // get the most recent call record
    var callRecord = new GlideRecord('notify_call');
    callRecord.orderByDesc('sys_created_on');
    callRecord.query();
     
    if (callRecord.next()) {
        // instantiate notify action container class
        var notifyAction = new SNC.NotifyAction();
        // The call is already in progress. Now, we want to modify the call behavior by putting this call in a queue.
        // So, we add a queue action to queue the call
        notifyAction.addQueue('my fancy queue');
       
        // modify the call by passing in the above action, putting the call in a queue
        new SNC.Notify().modifyCall(callRecord, notifyAction);
    } else {
        gs.log('no such call record');
    }

### Scoped equivalent {#r_N-modifyCall_GR_NA__section_a4l_chd_1gb}

To use the modifyCall() method in a scoped application, use the
corresponding scoped method: [NotifyScoped - modifyCall()](https://www.servicenow.com/docs/kMUk9CUt32E7w17E0qAk2w#NotifyScoped-modifyCall_GR_NA "Performs one or more activities on an active Notify phone call.").

## Notify - mute(GlideRecord participantRecord) {#ariaid-title14}

Mutes the specified conference call participant.
{#Notify-mute_GR__table_bch_xfg_yfb__entry__3}

| Name | Type | Description |
|-|-|-|
| participantRecord | GlideRecord | GlideRecord from the notify_participant table for the participant to mute. |
[Table 25. Parameters]

{#Notify-mute_GR__table_bch_xfg_yfb} {#Notify-mute_GR__table_cch_xfg_yfb__entry__2}

| Type | Description |
|-|-|
| void |   |
[Table 26. Returns]

{#Notify-mute_GR__table_cch_xfg_yfb}  
The following example shows how to mute a caller.

    var notifyParticipantGr = new GlideRecord('notify_participant');
    notifyParticipantGr.get('active participant sys id');
     
    if (notifyParticipantGr.isValid) {
        SNC.Notify.mute(notifyParticipantGr);
    }

### Scoped equivalent

To use the mute() method in a scoped application, use the corresponding
scoped method: [NotifyScoped - mute()](https://www.servicenow.com/docs/kMUk9CUt32E7w17E0qAk2w#NotifyScoped-mute_GR "Mutes the specified conference call participant.").

## Notify - queueCall(GlideRecord callRecord) {#ariaid-title15}

Puts the specified call into a queue (on hold).
Resume a queued call using the dequeueCall() method.
{#r_N-queueCall_GlideRecord__table_uhl_mcy_js__entry__3}

| Name | Type | Description |
|-|-|-|
| callRecord | GlideRecord | GlideRecord object of the Notify Call record (notify_call table) to put on hold. |
[Table 27. Parameters]

{#r_N-queueCall_GlideRecord__table_uhl_mcy_js} {#r_N-queueCall_GlideRecord__table_vhl_mcy_js__entry__2}

| Type | Description |
|-|-|
| void |   |
[Table 28. Returns]

{#r_N-queueCall_GlideRecord__table_vhl_mcy_js}  
The following example shows how to put a call on hold (in the queue).

    var notifyCallGr = new GlideRecord('notify_call');
    notifyCallGr.get('active participant sys id');
     
    if (notifyCallGr.isValid) {
        SNC.Notify.queueCall(notifyCallGr);
    }

### Scoped equivalent

To use the queueCall() method in a scoped application, use the
corresponding scoped method: [NotifyScoped - queueCall()](https://www.servicenow.com/docs/kMUk9CUt32E7w17E0qAk2w#NotifyScoped-queueCall_GR "Puts the specified call into a queue (on hold).").

## Notify - sendBulkSMS(String notifyPhoneNumber, Array toPhoneNumbers, String messageBody, GlideRecord source) {#ariaid-title16}

Sends a specified SMS message to the specified list of Notify clients (phone
numbers).
{#Notify-sendBulkSMS_NPN_S_S_GR__table_n2q_3zf_yfb__entry__3}

| Name | Type | Description |
|-|-|-|
| notifyPhoneNumber | String | Notify phone number from which the SMS message is being sent. |
| toPhoneNumbers | Array of Strings | Comma-separated list of phone numbers to which to send the SMS message. Format: E.164 |
| messageBody | String | SMS text to send. |
| source | GlideRecord | Source record that prompted this SMS message, such as an incident. |
[Table 29. Parameters]

{#Notify-sendBulkSMS_NPN_S_S_GR__table_n2q_3zf_yfb} {#Notify-sendBulkSMS_NPN_S_S_GR__table_o2q_3zf_yfb__entry__2}

| Type | Description |
|-|-|
| String | Null |
[Table 30. Returns]

{#Notify-sendBulkSMS_NPN_S_S_GR__table_o2q_3zf_yfb}  
The following example shows how to send a bulk SMS message.

    var incidentGr = new GlideRecord('incident');
    incidentGr.get(active incident sys_id');
    if (incidentGr.isValid()) {
        SNC.Notify.sendBulkSMS('+15413970605', ['+919885XXXXXX', '+919775XXXXXX'], 'Test automation message', incidentGr);
    }

### Scoped equivalent

To use the sendBulkSMS() method in a scoped application, use the
corresponding scoped method: [NotifyScoped - sendBulkSMS()](https://www.servicenow.com/docs/kMUk9CUt32E7w17E0qAk2w#NotifyScoped-sendBulkSMS_NPN_S_S_GR "Sends a specified SMS message to the specified list of Notify clients (phone numbers).").

## Notify - sendSMS(String notifyPhoneNumber, String toPhoneNumber, String messageBody, GlideRecord source) {#ariaid-title17}

Sends an SMS text message to an E.164-compliant phone number.
This method creates a new record on the Notify Message \[notify_message\] table and
associates it with the source record.
{#r_N-sendSMS_NPN_S_S_GR__table_dnk_4dn_wr__entry__3}

| Name | Type | Description |
|-|-|-|
| notifyPhoneNumber | String | Notify phone number from which the SMS message is being sent. |
| toPhoneNumber | String | E.164-compliant phone number to which to send the SMS message. |
| messageBody | String | Body of the SMS text message. |
| source | GlideRecord | Source record that prompted this SMS message, such as an incident. |
[Table 31. Parameters]

{#r_N-sendSMS_NPN_S_S_GR__table_dnk_4dn_wr} {#r_N-sendSMS_NPN_S_S_GR__table_enk_4dn_wr__entry__2}

| Type | Description |
|-|-|
| String | Unique message SID; stored in the Notify Message \[notify_message\] record as message_id. |
[Table 32. Returns]

{#r_N-sendSMS_NPN_S_S_GR__table_enk_4dn_wr}  
The following example shows how to send an SMS message.

    var incidentGr = new GlideRecord('incident');
    incidentGr.get('active incident sys_id');
    if (incidentGr.isValid()) {
        SNC.Notify.sendSMS('+15413970605', '+919885XXXXXX', 'Test automation message', incidentGr);
    }

### Scoped equivalent {#r_N-sendSMS_NPN_S_S_GR__section_kby_cyc_1gb}

To use the sendSMS() method in a scoped application, use the
corresponding scoped method: [NotifyScoped - sendSMS()](https://www.servicenow.com/docs/kMUk9CUt32E7w17E0qAk2w#NotifyScoped-sendSMS_NPN_S_S_GR "Sends an SMS text message to an E.164-compliant phone number.").

## Notify - unmute(GlideRecord participantRecord) {#ariaid-title18}

Unmutes the specified conference call participant.
{#Notify-unmute_GR__table_v1w_p3g_yfb__entry__3}

| Name | Type | Description |
|-|-|-|
| participantRecord | GlideRecord | GlideRecord from the notify_participant table for the participant to unmute. |
[Table 33. Parameters]

{#Notify-unmute_GR__table_v1w_p3g_yfb} {#Notify-unmute_GR__table_w1w_p3g_yfb__entry__2}

| Type | Description |
|-|-|
| void |   |
[Table 34. Returns]

{#Notify-unmute_GR__table_w1w_p3g_yfb}  
The following example shows how to unmute a caller.

    var notifyParticipantGr = new GlideRecord('notify_participant');
    notifyParticipantGr.get('active participant sys id');
     
    if (notifyParticipantGr.isValid) {
        SNC.Notify.unmute(notifyParticipantGr);
    }

### Scoped equivalent {#Notify-unmute_GR__section_a4l_chd_1gb}

To use the unmute() method in a scoped application, use the corresponding
scoped method: [NotifyScoped - unmute()](https://www.servicenow.com/docs/kMUk9CUt32E7w17E0qAk2w#NotifyScoped-unmute_GR "Unmutes the specified conference call participant.").

