---
sourceDocument: Australia IT Service Management
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/it-service-management

 Release :

    - australia

ft:locale :

    - en-US

ft:publication_title :

    - Australia IT Service Management

ft:clusterId :

    - itsm

bundleId :

    - itsm

workflow :

    - Technology


---

# Send a Desktop Assistant notification from server-side script

# Send a Desktop Assistant notification from server-side script {#ariaid-title1}

Release version: Australia  
Updated May 5, 2026  
![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 minute to read  
Use DesktopAppNotificationUtils to send Desktop Assistant notifications to users from a server-side script.

## Before you begin

Role required: sn_dex_desktop.admin or admin

## Procedure

1. Navigate to System PropertiesAll Properties and confirm that sn_dex_desktop.enable_push_notification is set to true.  
   If the property is set to false, the API immediately returns a 400 error and no notification is created.
2. Collect valid sys_id values from the User (sys_user) table for each intended notification recipient and format them as a comma-separated string.
3. Navigate to the server-side context where you want to trigger the notification.  
   For example, a Background Script for testing, a business rule, scheduled job, or flow script step for production use.
4. Call sendDANotification() with notification_message, recipient_list, and source as the minimum required parameters.  
   Note:  
   The source parameter accepts <kbd class="ph userinput">mim</kbd> (Major Incident Management) or <kbd class="ph userinput">pe</kbd> (Proactive Engagement) as its value.
   Example of API call script structure:

       var utils = new sn_dex_desktop.DesktopAppNotificationUtils();
       var result = utils.sendDANotification({
           notification_title:   "Incident Assigned to You",
           notification_message: "INC0001234 has been assigned to your group. Please review.",
           recipient_list:       "abc123def456...,xyz789...",  // sys_id values, comma-separated
           referrer_table:       "incident",
           referrer_id:          "<incident_sys_id>",
           source:               "mim"
       });
       gs.info(JSON.stringify(result));

   For examples of sending Desktop Assistant notifications using DesktopAppNotificationUtils, see [Examples of Desktop Assistant notifications using DesktopAppNotificationUtils](https://servicenow-prod.fluidtopics.net/mXMgngKZVKSp3YLrJS3pdw "Examples showing the sendDANotification() method of DesktopAppNotificationUtils used to send a Major Incident Management (MIM) alert and a Proactive Engagement (PE) notification.").
5. Check the return value to confirm the API call was successful.  
   A successful call returns a `responseCode` of 200 and a `notification_id`
   in the `metadata` field of the response object. Any other response code indicates that the notification was not queued, and the `message` field of the response object
   states the reason.
6. Verify that the notification was delivered to the Desktop Assistant client.  
   For more information, see [View Desktop Assistant notifications](https://servicenow-prod.fluidtopics.net/~PWreZ2AeiOmyfmIUI3ohA "View notifications to stay up to date with important information and events in real time."). If the notification does not appear on the Desktop Assistant client, see [Troubleshoot Desktop Assistant notification delivery](https://servicenow-prod.fluidtopics.net/0cg4fCk_buH~Dgb5hdNYKw "Check notification records, queue processing, event handling, logs, and the endpoint client to identify why Desktop Assistant notifications aren't delivered.").
{#send-da-notifications-from-script__steps_anv_lvn_2jc}

*[\>]: and then