To create Ios Lock Screen Message
https://{server-hostname}:8383/api/v1/mdm/profiles/{profile_id}/payloads/ioslockscreenmessage
MDMDeviceMgmt.CREATECopied!
Authorization: d92d4xxxxxxxxxxxxx15f52
Unique identifier of the profile. Obtain from the Create Profile or Get Profiles response
Wallpaper type for lock screen. Allowed values: 1=Background Color, 2=Uploaded Image
Bg Colour
Wallpaper file id. Use the fileID from the File Upload API response
List of lock screen messages
Message text to display on lock screen
Text colour hex code (e.g. #FFFFFF)
Vertical offset position of the message
Wallpaper Modified
Orientation. Default: 1
curl --request POST \
--url https://appdomain/api/v1/mdm/profiles/{profile_id}/payloads/ioslockscreenmessage \
--header 'Accept: application/json' \
--header 'Authorization: d92d4xxxxxxxxxxxxx15f52' \
--header 'Content-Type: application/json' \
--data '"{ \"wallpaper_type\": -1, \"bg_colour\": \"value\", \"wallpaper\": \"value\", \"wallpaper\": \"value\", \"messages\": [{\"message\": \"Zylker message\", \"text_colour\": \"#000000\", \"offset_position\": 0}], \"wallpaper_modified\": false, \"orientation\": 1 }"'Add Lock Screen Message payload to the profile
"{ \"wallpaper_type\": -1, \"bg_colour\": \"value\", \"wallpaper\": \"value\", \"wallpaper\": \"value\", \"messages\": [{\"message\": \"Zylker message\", \"text_colour\": \"#000000\", \"offset_position\": 0}], \"wallpaper_modified\": false, \"orientation\": 1 }"
Unique identifier for the created payload item
Wallpaper type for lock screen. Allowed values: 1=Background Color, 2=Uploaded Image
Bg Colour
Wallpaper. Use the fileID from the File Upload API response
List of lock screen messages
Message text to display on lock screen
Text colour hex code (e.g. #FFFFFF)
Vertical offset position of the message
Wallpaper Modified
Orientation. Default: 1
Lock Screen Message payload successfully added
"{ \"payload_id\": 9007199254741001, \"wallpaper_type\": -1, \"bg_colour\": \"value\", \"wallpaper\": \"value\", \"wallpaper\": \"value\", \"messages\": [{\"message\": \"Zylker message\", \"text_colour\": \"#000000\", \"offset_position\": 0}], \"wallpaper_modified\": false, \"orientation\": 1 }"
![]()
Duration: 1 minute | Threshold: 30 | Lock period: 5 minutes
Duration - Time window for the threshold.
Threshold - Number of API calls allowed within the specified duration.
Lock Period - Wait time before consecutive API requests.
© 2026, Zoho Corporation Pvt. Ltd. All Rights Reserved.
© 2026, Zoho Corporation Pvt. Ltd. All Rights Reserved.