Add a new Service Management payload configuration to an existing profile To create Mac service Mgmt policy
Request URL https://{serverurl} /api/v1/mdm/profiles/{profile_id}/payloads/macservicemgmtpolicy
Scope
Header Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52
Request Parameters - Request Headers Content-Type string Mandatory
- Path Parameters profile_id string Mandatory
- Request Body application/json JSON object
Hide Sub-Attributes mac_service_mgmt_rules JSON array Optional
List of rules controlling which services and daemons are allowed or denied on the Mac
Show Sub-Attributes JSON object
Show Sub-Attributes rule_type integer Optional
Service rule type. Allowed values: 1=Allow, 2=Deny
rule_value string Optional
Bundle identifier or launchd label of the service or daemon (e.g., com.apple.smbd)
comment string Optional
Optional descriptive comment explaining the purpose of this rule
Curl
Java
Python
Deluge
PowerShell
Copied!
curl --request POST \
--url https://appdomain/api/v1/mdm/profiles/{profile_id}/payloads/macservicemgmtpolicy \
--header 'Accept: application/json' \
--header 'Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52' \
--header 'Content-Type: application/json' \
--data '{}'import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.io.IOException;
import java.net.http.HttpTimeoutException;
public class Main {
public static void main(String[] args) {
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://appdomain/api/v1/mdm/profiles/{profile_id}/payloads/macservicemgmtpolicy"))
.header("Content-Type", "application/json")
.header("Accept", "application/json")
.header("Authorization", "Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52")
.method("POST", HttpRequest.BodyPublishers.ofString("{}"))
.build();
HttpResponse response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
}
}
import http.client
conn = http.client.HTTPSConnection("appdomain")
payload = "{}"
headers = {
'Content-Type': "application/json",
'Accept': "application/json",
'Authorization': "Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52"
}
conn.request("POST", "/api/v1/mdm/profiles/{profile_id}/payloads/macservicemgmtpolicy", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
headersMap = Map();
headersMap.put("Content-Type", "application/json");
headersMap.put("Accept", "application/json");
data=Map();
response = invokeUrl
[
url: "https://appDomain/api/v1/mdm/profiles/{profile_id}/payloads/macservicemgmtpolicy"
type: POST
headers: headersMap
body: data
connection: connection_name
]
info response;
$headers=@{}
$headers.Add("Content-Type", "application/json")
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", "Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52")
$response = Invoke-WebRequest -Uri 'https://appdomain/api/v1/mdm/profiles/{profile_id}/payloads/macservicemgmtpolicy' -Method POST -Headers $headers -ContentType 'application/json' -Body '{}'Sample Request Body Add Service Management payload to the profile
Copied!
{
"mac_service_mgmt_rules": [
{
"rule_type": 1,
"rule_value": "com.zylker.service",
"comment": "Zylker rule"
}
]
}
▼ Show full
Response Parameters - HTTP code 200 Response Body - application/json JSON object
Hide Sub-Attributes payload_id long
Unique identifier for the created payload item
mac_service_mgmt_rules JSON array
List of service management rules configured for this payload
Show Sub-Attributes JSON object
Show Sub-Attributes rule_type string
Service rule type. Values: 1=Allow, 2=Deny
rule_value string
Bundle identifier or launchd label of the service or daemon
comment string
Descriptive comment explaining the purpose of this rule
Possible Response Codes Sample Response: HTTP 200 Service Management payload successfully added
Copied!
{
"payload_id": 9007199254741000,
"mac_service_mgmt_rules": [
{
"rule_type": 1,
"rule_value": "com.zylker.service",
"comment": "Zylker rule"
}
]
}
▼ Show full
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.