---
sourceDocument: Brazil IT Operations Management
sourceDocumentLink: https://www.servicenow.com/docs/r/it-operations-management

 Release :

    - brazil

ft:locale :

    - en-US

ft:publication_title :

    - Brazil IT Operations Management

ft:clusterId :

    - itom

bundleId :

    - itom

workflow :

    - Technology


---

# Send a Desktop Assistant notification from a server-side script

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

Release version: Brazil  
Updated September 10, 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, use a background script for testing, or a business rule, a scheduled job, or a 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://www.servicenow.com/docs/iFoVY1d1KCERr0kqc27dLQ "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 that 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://www.servicenow.com/docs/1c~5QNFiE800M2mHoAaRrg "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://www.servicenow.com/docs/4cMV7s6ru45CsT_J1m2Vxg "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