Creates and deploys a new announcement with the specified message, schedule window (start time, end time, lap time), platform, and target computers or groups. Accepts a JSON body with the full announcement collection configuration.
post /dcapi/tools/announcement/deploy
https://{serverurl}/dcapi/tools/announcement/deploy
Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52
curl --request POST \
--url https://appdomains/dcapi/tools/announcement/deploy \
--header 'Accept: application/announcementDeployStatus.v1+json' \
--header 'Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52' \
--header 'Content-Type: application/announcementCollectionDetails.v1+json' \
--data '{"label":"Maintenance Window Notice"}' {
"deployAction": "Deploy",
"configDetails": [
{
"toolDetails": {
"repeatFrequency": 1,
"repeatDuration": 600,
"startTime": "22:00",
"endTime": "02:00",
"message": "System maintenance tonight from 11 PM to 2 AM."
}
}
],
"label": "Maintenance Window Notice",
"isModify": false,
"configType": "Computer",
"collectionID": 0,
"targetDetails": {
"envType": 0,
"targetValue": "Engineering",
"targetType": "CustomGroup"
}
}
Result of the create or update operation: success or failure
Unique identifier of the created or updated task collection
{
"collectionId": 7,
"status": "success"
}
![]()
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.