Validates the proposed announcement schedule times by checking them against the server's configured timezone. Accepts 'startTime', 'endTime', 'lapTime', and 'isMultipleTime' query parameters. Returns whether the time window is valid.
get /dcapi/tools/announcement/validateTime
https://{serverurl}/dcapi/tools/announcement/validateTime
Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52
Announcement start time string. Validated against the server's configured timezone
Announcement end time string. Must be after startTime. Validated against the server's configured timezone
Interval time between repeated announcement displays within the schedule window
Set to true when the announcement should repeat multiple times within the schedule window
curl --request GET \
--url https://appdomains/dcapi/tools/announcement/validateTime \
--header 'Accept: application/json' \
--header 'Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52'true if the provided start and end times form a valid schedule window
Server timezone identifier used for time validation (e.g., America/New_York)
Epoch timestamp of the parsed start time in server timezone
Epoch timestamp of the parsed end time in server timezone
{
"isValid": true,
"serverTimezone": "America/New_York",
"parsedStartTime": 1711400000000,
"parsedEndTime": 1711436000000
}
![]()
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.