Skip to main content

Webhooks Framework

SureMDM enables the capture of real-time notifications for particular device-related occurrences through the utilization of Webhook URLs. This dynamic functionality provides a swift and efficient method to stay updated about modifications to specific device events within SureMDM. Once you activate the relevant events, SureMDM seamlessly transmits data to the designated URL whenever any of these events take place, ensuring you receive timely insights into the changes occurring in your device ecosystem.

Following steps are involved in capturing the event notifications on your Webhook URL:

  • Configure Webhooks in SureMDM
  • Create a notification policy job and apply it to a device

Configure Webhooks in SureMDM​

To configure Webhooks in SureMDM, follow these steps:

  1. Navigate to the SureMDM Web Console > Settings (icon located at the top right of the console) > Account Settings > Enterprise Integrations > Webhooks.

  2. Select Enable Webhooks.

  3. Click Add New Endpoint.

  4. Enter the Webhook Name and Webhook Endpoint.

note

Webhook Endpoint is your Webhook URL, where specified device-related events are captured.

  1. Click Test Connection to confirm the connection with your Webhook URL.

  2. Select an option for the Webhook Subscription to capture notification for the below events:

Webhook Subscription EventDescription
Device EnrollmentNotification will be triggered when device is enrolled.
Device DeleteNotification will be triggered when device is deleted.
Device WipeNotification will be triggered when device is wiped.
Device Moved to Another GroupNotification will be triggered when device is moved from one group to another.
Device Unlicensed/Device RenewedNotification will be triggered when device is renewed / went unlicensed.
Device Added to ADE ServerNotification will be triggered when a new device is added to an ADE server and fetched into SureMDM Console.
SIM Change (iOS)Notification will be triggered when a SIM card is changed in iOS / iPadOS devices.
  1. Click Save > Apply.

Create Notification policy job and apply it to a device​

To configure an event notification and capture it on the Webhook URL, follow these steps:

  1. On the SureMDM Web Console, navigate to Jobs > New Job > Android > Notification Policy.

  2. Name the job and configure notification settings for the following events:

  • Battery percentage or battery charging status change – Send a notification when an enrolled device’s battery power falls below the set threshold and battery charging status changes.
  • Device connection status change – Send a notification when the device remains offline for a set period.
  • Device data usage threshold change – Send a notification when the device’s data consumption exceeds the set threshold.
  • Device status change – Send a notification when SureMDM Agent application status becomes online after being offline.
  • Send a notification when a SIM is changed or the device is rooted, or when SureMDM Agent is granted root permission.

  1. Enable Webhook and select the Endpoint URL given in step no.4, Configure Webhooks in SureMDM to send an alert to the selected Webhook URL.

  2. Click Done > OK.

    The newly created job will be listed under Jobs List . 

  3. Go back to Home and select the Android device. 

  4. Click Apply to launch the Apply Job/Profile To Device prompt.

  5. In the Apply Job/Profile To Device prompt, select the created job and click Apply.

    Once the job is applied to a device, you can see a real-time event notification captured on your Webhook URL in JSON format whenever the status of the policies configured on the enrolled device changes.

    The above example is that of an event notification captured on the Webhook URL that occurred as a result of the device battery power dropping below a set threshold. 

note

You can also capture event notifications for Android Wear, Windows CE, Windows Mobile, Windows 7, 8 and 10 devices on the Webhooks.