Message APIs

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

Data Type: String

Subject of the email. Character limit is 100.

Please backup your device.

body

Parameter Type: Request body

Data Type: String

Body of the email. Character limit is 3000.

Please backup your device to ensure against data loss.

html

Parameter Type: Request body

Data Type: Boolean

Specifies whether the email is in HTML format.

true

identifiers

Required

Parameter Type: Request body

Data Type: String

List of UEM identifiers in this format:

{

"identifiers":["mdm-id-1", "mdm-id-2"]

}

See List of identifiers.

 

See List of identifiers.

Response fields

Success: HTTP Status 200

See Number result.