---
title: Message APIs
slug: cps-guide/mdm-epmm/message-apis
createdAt: 2026-10-06T07:45:20.767Z
---

## Send email to device owners

This API is used to send email notification to device owners by specifying device identifiers in the request. The API returns the count of devices for which the send email action was successfully initiated. Any invalid device identifier specified in the request is silently ignored.

### HTTP Method

POST

### Request URI

/msa/v1/cps/device/email

### Request parameters

| Parameter   | Description                                                                                                                                                                                                                                 | Sample Value                                           |
| ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------ |
| subject     | **Parameter Type:** Request body<br />**Data Type:** String<br />Subject of the email. Character limit is 100.                                                                                                                              | Please backup your device.                             |
| body        | **Parameter Type:** Request body<br />**Data Type:** String<br />Body of the email. Character limit is 3000.                                                                                                                                | Please backup your device to ensure against data loss. |
| html        | **Parameter Type:** Request body<br />**Data Type:** Boolean<br />Specifies whether the email is in HTML format.                                                                                                                            | true                                                   |
| identifiers | Required<br />Parameter Type: Request body<br />**Data Type:** String<br />List of UEM identifiers in this format:<br />\{<br />"identifiers":\["mdm-id-1", "mdm-id-2"]<br />}<br />See [List of identifiers](docId:0FgXpF4sPOcu6M7eESvy1). |                                                        |

See [List of identifiers](docId:0FgXpF4sPOcu6M7eESvy1).

### Response fields

Success: HTTP Status 200

See [Number result](docId:0FgXpF4sPOcu6M7eESvy1).
