Creates a new replication policy with transfer rates, schedule, and time window configuration.
post /dcapi/som/replication-policies
https://{serverurl}/dcapi/som/replication-policies
Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52
Administrator-defined display name for the replication policy (max 250 characters)
Optional administrator-provided description for the replication policy (max 1000 characters)
Interval in minutes at which the Distribution Server syncs data with the central server
WAN data transfer rate limit in Kbps. Allowed values: 0 (unlimited), 512, 1024, 2048, 3072, 4096, 5120, 6144, 7168, 8192
curl --request POST \
--url https://appdomains/dcapi/som/replication-policies \
--header 'Accept: application/replicationPolicyAddStatus.v1+json' \
--header 'Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52' \
--header 'Content-Type: application/replicationPolicyDetails.v1+json' \
--data '{}'Create a business-hours replication policy
{
"policyName": "Business Hours Only",
"replicationInterval": 30,
"description": "Replicate only during business hours",
"dataTransferRate": 512
}
Indicates whether the replication policy was created successfully
Descriptive message confirming creation or explaining the reason for failure (e.g., 'Replication policy - Business Hours Only has been created successfully')
Contains the identifier of the newly created replication policy
Unique identifier of the newly created replication policy
HTTP status code (412)
Precondition failed error code identifying the business logic violation
Error message describing the precondition failed while processing request
Policy created
{
"data": {
"replicationPolicyID": 5
},
"message": "Replication policy - Business Hours Only has been created successfully",
"status": true
}
Required replication policy parameters are missing
{
"errorCode": "30090",
"message": "Required replication policy parameters are missing",
"statusCode": 412
}
Invalid replication interval or insufficient replication window
{
"errorCode": "30086",
"message": "Invalid replication interval or insufficient replication window",
"statusCode": 412
}
Replication policy with same name already exists
{
"errorCode": "30025",
"message": "A replication policy with the same name already exists",
"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.