--- 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 --- # Customizing Desktop Assistant notifications using API parameters # Customizing Desktop Assistant notifications using API parameters {#ariaid-title1} Release version: Australia Updated April 28, 2026 ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 minutes to read Administrators can send customized Desktop Assistant notifications to specific users by using the DesktopAppNotificationUtils script include with a set of notification parameters. Desktop Assistant notifications are sent using the sendDANotification() method of the DesktopAppNotificationUtils script include in the sn_dex_desktop application scope. This method runs server-side and can be called from business rules, background scripts, scheduled jobs, Flow Script Steps, or Flow Designer actions. It is not exposed as a REST endpoint or Notify API. The Desktop Assistant client displays these notifications on the user's device, alerting employees to time-sensitive events such as major incidents affecting their services or software licenses nearing expiration. By default, Major Incident Management (MIM) and Proactive Engagement (PE) send notifications through Desktop Assistant without invoking this API. For more information, see [Desktop Assistant notifications](https://servicenow-prod.fluidtopics.net/zczoQxNtT1IZi27VHblY3Q "Desktop Assistant notifications enable your organization to communicate important updates to end users instantly, regardless of their device activity. This feature enables delivering critical information, supporting Major Incident Management and Proactive Engagement."). Use the DesktopAppNotificationUtils API to send notifications from additional sources. Note: Desktop Assistant notifications require the Desktop Assistant client to be installed and running on the user's endpoint device. ## Desktop Assistant notification delivery process {#customizing-da-notifications-api__section_ems_qyy_bjc} 1. Server-side trigger: A server-side component such as a business rule, Flow Designer action, or Scheduled Job initiates the notification delivery process by calling the sendDANotification() method on the DesktopAppNotificationUtils script include. 2. Validation and record creation: The script include validates the input parameters and inserts a record into the Desktop Assistant notification (sn_dex_desktop_assistant_notification) table if validation succeeds. This record stores the notification title, message body, recipient list or device list, source, and expiry date. 3. Asynchronous background processing: Creating the notification record triggers the desktop_assistant_notification_call background flow. This flow runs asynchronously, allowing the original caller to continue without waiting for delivery processing to complete. 4. Notification preparation and queuing: The background flow calls the internal DesktopNotificationAPI.sendNotification() method, which prepares the notification for delivery and inserts rows into the Desktop Assistant Notification Queue (sn_dex_desktop_notify_queue) table. Each row in this table represents one delivery attempt for one device token. 5. Notification delivery to the endpoint: The Agent Client Collector (ACC) running on the end user's device retrieves pending entries from the queue and delivers the notification to the Desktop Assistant client. By default, notification delivery is event-driven. The platform triggers the sn_dex_desktop.triggerCheckdef event, which signals the ACC agent to check for new notifications. {#customizing-da-notifications-api__ol_p5w_hfz_bjc} ## How notifications appear in the Desktop Assistant client {#customizing-da-notifications-api__section_v1p_4j1_cjc} Each Desktop Assistant notification appears as a card in the Desktop Assistant notification panel. The notification card displays the title, message body, and a timestamp indicating when the notification was sent. If a notification is associated with a ServiceNow record, the card includes a deep link that opens the linked record directly. When the user's device is active at notification delivery time, a brief system tray toast notification also appears. The toast disappears automatically, while the notification card remains available in the Desktop Assistant panel for later reference. ## Notification visibility duration {#customizing-da-notifications-api__section_mq3_cm1_cjc} The sn_dex_desktop.sn_desktop_assistant.notification_time_to_live system property controls notification visibility duration in the Desktop Assistant client. You can set this value from 1 to 7 days, with a default of 7 days. If a value greater than 7 days is configured, the visibility period is limited to seven days. After the notification reaches its expiry date, it is automatically removed from the Desktop Assistant notification panel. **Related concepts** * [Setting up DEX Desktop Assistant](https://servicenow-prod.fluidtopics.net/CZIO3Xi1Fu9zj7J8EcQH_Q "Configure Desktop Assistant so employees can access self-service tools, support channels such as Employee Center and Virtual Agent, and notifications about outages and announcements directly from their desktop.") * [Desktop Assistant notifications](https://servicenow-prod.fluidtopics.net/zczoQxNtT1IZi27VHblY3Q "Desktop Assistant notifications enable your organization to communicate important updates to end users instantly, regardless of their device activity. This feature enables delivering critical information, supporting Major Incident Management and Proactive Engagement.") **Related tasks** * [Send a Desktop Assistant notification from server-side script](https://servicenow-prod.fluidtopics.net/qeooZ0OFjI_7PBXisnrJpw "Use DesktopAppNotificationUtils to send Desktop Assistant notifications to users from a server-side script.") **Related reference** * [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.") * [API parameters to configure Desktop Assistant notifications](https://servicenow-prod.fluidtopics.net/l6xpaFY6UgoTRB9_oprINQ "sendDANotification() method parameters in the DesktopAppNotificationUtils script include for configuring Desktop Assistant notifications.") * [Digital End-User Experience properties and settings](https://servicenow-prod.fluidtopics.net/QusqMfIM~V8Elm6gFB7Xgg "You can update the following Digital End-User Experience properties and settings to fit your needs. You must have the admin role to update these settings and properties.")