---
title: Send Message to Devices
slug: epmm/v1web-service-api-guide/send-message-to-devices
createdAt: 2026-11-03T13:09:52.530Z
---

This request sends a message to one or more devices using email, SMS or push notification (e.g., APNS).

Ivanti EPMM validates that the request has valid devices, and then sends the response. Ivanti EPMM sends the messages to the devices after sending the response. You can view the results of sending the messages by looking at Logs & Events | All Logs in the Admin Portal.

If some devices are invalid, the response lists them, but Ivanti EPMM will still send the message to the valid devices.

**Examples**:

Send an SMS to two devices based on UDID.

https\://app027.auto.Ivanti.com/api/v1/dm/bulk/sendmessage?mode=sms\&message=Hello World\&deviceUuid=e6d4f5f0-d883-41d2-8e87-c76fb4ef4cde\&deviceUuid=54bc5eb5-592c-472e-98d2-e859bd037fef

The resulting response:

\<deviceManagementWebServiceResponse>

\<messages/>

\<message> Message sent successfully for all devices.\</message>

\</deviceManagementWebServiceResponse>

Send an SMS to a device based on Wi-Fi MAC address:

https\://app027.auto.Ivanti.com/api/v1/dm/bulk/mac/sendmessage?mode=sms\&message=Hello World\&deviceWiFiMacAddress=00237696635F

| 1.URI:<br />https\:///api/v1/dm/bulk/sendmessage                |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| --------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Http Method:                                                    | POST                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| Format:                                                         | xml, json<br />                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| Request:                                                        |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| deviceUuid                                                      | Required.<br /><br />List each device uuid as a query parameter that has the name deviceUuid. By default, the maximum number of device uuids you can list is 20,000.<br /><br />You can configure this value by setting the variable bulk.api.maxdeviceuuids in the file mifs.properties. This file is located in the directory /mi/tomcat-properties in the Linux system in which Ivanti EPMM is running.<br /><br />Warning: The name of this parameter is deviceUuid, with no “s” at the end. |
| message                                                         | Required.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| subject                                                         | Valid only when the mode is email.                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| mode                                                            | Required. Possible values:<br />sms<br />email<br />pns (indicates push notification service)                                                                                                                                                                                                                                                                                                                                                                                                    |
|                                                                 |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| 2.URI:<br />https\:///api/v1/dm/bulk/mac/sendmessage            |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| Http Method:                                                    | POST                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| Format:                                                         | xml, json<br />                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| Request:                                                        |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| deviceWiFiMacAddress                                            | Required.<br /><br />List each Wi-Fi MAC address  as a query parameter that has the name macAddress.<br />                                                                                                                                                                                                                                                                                                                                                                                       |
| message                                                         | Required.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| subject                                                         | Valid only when the mode is email.                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| mode                                                            | Required. Possible values:<br />sms<br />email<br />pns                                                                                                                                                                                                                                                                                                                                                                                                                                          |
|                                                                 |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| Response Status Code:                                           |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| ‘404 – No Data Found’                                           | There is no data.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| ‘200 – OK’                                                      | Data is present and the response is returned.                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| Response:                                                       |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| \< deviceManagementWebServiceResponse >                         |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| \<messages>                                                     |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| \<message>Message sent successfully for all devices.\</message> | Status information.<br />                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| \</messages>                                                    |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| \<invalidDevices>                                               | If the request contains one or more invalid device uuids, this field lists them.                                                                                                                                                                                                                                                                                                                                                                                                                 |
|            \<uuid> 1ac8bd81-4ab9-4e3e-b3a8-0c4f70521d23\</uuid> |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
|            \<uuid> 623094f9-645b-4ecf-8840-78597cc1254b\</uuid> |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| \</invalidDevices>                                              |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| \</messageSentFailed>                                           | Indicates the message was not sent for at least one specified device, due to, for example, an invalid device uuid.                                                                                                                                                                                                                                                                                                                                                                               |
| \< /deviceManagementWebServiceResponse>                         |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |

##

|   |
| - |