To modify Ios Lock Screen Message payload item
https://{server-hostname}:8383/api/v1/mdm/profiles/{profile_id}/payloads/ioslockscreenmessage/payloaditems/{payload_id}
MDMDeviceMgmt.UPDATECopied!
Authorization: d92d4xxxxxxxxxxxxx15f52
Unique identifier of the profile. Obtain from the Create Profile or Get Profiles response
Unique identifier of the payload item. Obtain from the Get Payload Item IDs response
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
curl --request PUT \
--url https://appdomain/api/v1/mdm/profiles/{profile_id}/payloads/ioslockscreenmessage/payloaditems/{payload_id} \
--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 }"'Modify Lock Screen Message payload item
"{ \"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 of the 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 item successfully modified
"{ \"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: 60 | 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.