Initiates an MDM profile installation request on one or more computers.
https://{server-hostname}:8383/dcapi/som/computers/actionRequest/mdm-profile/install
SOM.CREATECopied!
Authorization: d92d4xxxxxxxxxxxxx15f52
Array of computer resource IDs to perform the operation, get computer IDs from the response of the Computers API, under the resource_id field.
curl --request POST \
--url https://appdomain/dcapi/som/computers/actionRequest/mdm-profile/install \
--header 'Accept: application/mdmProfileInstallationStatus.v1+json' \
--header 'Authorization: d92d4xxxxxxxxxxxxx15f52' \
--header 'Content-Type: application/computerIdsToInstallMDM.v1+json' \
--data '{"computerIDs":[2001,2002]}'Install MDM profile on computers
{
"computerIDs": [
2001,
2002
]
}
Array of computer resource IDs originally submitted in the MDM profile installation request
Indicates whether the MDM profile installation request was accepted and initiated successfully
Descriptive message providing details about the installation outcome or any errors encountered
Unique tracking identifier for this action request. Use this ID to poll status
Total number of computers selected by the user for MDM profile installation
Number of computers that meet the prerequisites for MDM profile installation
Number of computers that do not meet the prerequisites for MDM profile installation (e.g., unsupported OS)
Number of computers where the MDM profile installation was successfully initiated
Number of computers where the MDM profile installation could not be initiated (e.g., agent offline, pre-check failed)
Indicates whether the MDM enrollment process is currently running across the selected computers
Array of computer resource IDs that were processed for MDM profile installation
HTTP status code (400)
API-specific error code identifying the validation failure
Error message describing the validation failure
HTTP status code (412)
Precondition failed error code identifying the business logic violation
Error message describing the precondition failed while processing request
MDM profile install initiated
{
"computerIDs": [
2001,
2002
],
"applicableComputersCount": 2,
"notApplicableComputersCount": 0,
"failureComputersCount": 0,
"mdmEnrollmentInProgress": true,
"message": "",
"selectedComputersCount": 2,
"successComputersCount": 0,
"actionRequestID": "AR-MDM-1712567890123",
"requestedComputers": [
2001,
2002
],
"status": true
}
Missing or empty computerIDs in request
{
"errorCode": "20006",
"message": "Resource IDs are not present in the request",
"statusCode": 400
}
Non-admin user cannot access the requested computers
{
"errorCode": "20005",
"message": "Selected computers are not accessible",
"statusCode": 412
}
Some computers are not managed by the server
{
"errorCode": "30007",
"message": "All resources are not managed computers",
"statusCode": 412
}
![]()
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.