Initiates an immediate AD synchronization for a specific domain. Returns whether the sync was successfully started or is already in progress.
post /dcapi/som/domains/{domain_id}/sync
https://{server-hostname}:8383/dcapi/som/domains/{domain_id}/sync
SOM.CREATECopied!
Authorization: d92d4xxxxxxxxxxxxx15f52
curl --request POST \
--url https://appdomain/dcapi/som/domains/{domain_id}/sync \
--header 'Accept: application/domainTreeSyncStatus.v1+json' \
--header 'Authorization: d92d4xxxxxxxxxxxxx15f52'Indicates whether the Active Directory synchronization process is now running for this domain
Indicates whether the synchronization request was accepted and initiated successfully
Descriptive message confirming the sync initiation or explaining why it could not be started (e.g., 'Domain sync is already in progress')
HTTP status code (412)
Precondition failed error code identifying the business logic violation
Error message describing the precondition failed while processing request
Sync initiated successfully
{
"message": "Domain sync initiated for ECSOM",
"isDomainAdSyncInProgress": true,
"status": true
}
Domain sync is already in progress
{
"errorCode": "10015",
"message": "AD Domain Sync is already in progress. Sync attempt failed.",
"statusCode": 412
}
Daily sync limit reached
{
"errorCode": "30104",
"message": "Reached daily limit to initiate domain Sync",
"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.