Creates a new alert profile and returns the generated profile identifier.
post /intelligence/api/alerts/addPolicy
https://{serverurl}/intelligence/api/alerts/addPolicy
Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52
Unique alert profile name
Profile description
List of metric rule definitions
Metric key identifying the selected alert rule template
Rule parameter map keyed by template identifier
Rule parameter object keyed by numeric template id
Configured value for the parameter
Configured display unit for the parameter
Alert type and grouped threshold details
Alert mode. Allowed values: Individual, Grouped
Minimum impacted endpoint threshold for grouped alerts
Monitoring interval in minutes
Alert priority. Allowed values: Critical, High, Medium, Low
Cool-off period in minutes
Notification configuration details
Whether notification is enabled for the profile
Notification group identifier when available
Email notification channel details
Email template identifier associated with notification group
Configured recipient email addresses
curl --request POST \
--url https://appdomains/intelligence/api/alerts/addPolicy \
--header 'Accept: application/alertRuleAdded.v1+json' \
--header 'Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52' \
--header 'Content-Type: application/alertRuleDetails.v1+json' \
--data '{}'Create grouped alert profile with email notification
{
"alertTypeJSON": {
"alertType": "Grouped",
"endpointsCount": "5"
},
"notification": {
"enabled": true,
"email": {
"addresses": [
"ops-team@example.com"
]
}
},
"coolOffPeriod": "30",
"monitoringInterval": "5",
"ruleName": "High CPU Spike",
"description": "Alert when CPU usage is sustained above threshold",
"rules": [
{
"metricKey": "301",
"ruleParams": {
"7001": {
"ruleUnit": "%",
"paramValue": "90"
},
"7002": {
"ruleUnit": "minutes",
"paramValue": "10"
}
}
}
],
"priority": "High"
}
Generated alert profile identifier
Localized success message
Validation error code for add policy request
Validation failure message for add policy request
Internal server error code for add policy operation
Internal server error message for add policy operation
Profile created successfully
{
"alertProfileId": 1051,
"Message": "High CPU Spike created successfully"
}
Missing mandatory request data
{
"errorMessage": "Required input is missing or invalid",
"errorCode": "GENERIC0002"
}
Server side failure
{
"errorMessage": "Unable to create alert policy due to internal error",
"errorCode": "INTERNAL_ERROR"
}
![]()
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.