Imports webdomains from a CSV file and associates them with a webdomain group.
post /bsp/api/v1/bmp/webdomains/csvimport
https://{serverurl}/bsp/api/v1/bmp/webdomains/csvimport
Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52
JSON body with group details and CSV file reference
Request body for CSV-based bulk webdomain import
Name of the webdomain group. Maximum 50 characters.
Description of the webdomain group. Maximum 100 characters.
File ID of the uploaded CSV file to import.
curl --request POST \
--url https://appdomains/bsp/api/v1/bmp/webdomains/csvimport \
--header 'Accept: application/json' \
--header 'Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52' \
--header 'Content-Type: application/json' \
--data '{}'Initiate CSV import
{
"csv_file_id": 12345,
"webdomain_group_name": "Blocked Sites",
"description": "Bulk imported blocked sites"
}
CSV import progress/status response
Total number of webdomains in the CSV file
Current import status: in_progress, success, or failed
Bad request error for CSV import validation failures
Message describing the CSV validation failure
Validation error code for the specific CSV issue
Unauthorized error code: credentials missing, expired, or invalid
Authentication failure reason
Error code indicating insufficient permissions
Message indicating insufficient privileges to access this resource
Rate limit error code returned when the API call reached threshold
Rate limit exceeded message with retry guidance
Internal server error during CSV import processing
Message describing the server-side failure
Internal server error code
Import started
{
"total": "2",
"status": "in_progress"
}
Too many entries
{
"error_description": "CSV contains more than 1000 entries",
"error_code": "BSP_COM0023"
}
Empty file
{
"error_description": "CSV file is empty",
"error_code": "BSP_COM0027"
}
Unauthorized
{
"errorCode": "UNAUTHORIZED",
"errorMsg": "You are not authorized to perform this action"
}
Forbidden
{
"errorCode": "FORBIDDEN",
"errorMsg": "You do not have permission to access this resource"
}
Rate limit exceeded
{
"errorCode": "RATE_LIMIT_EXCEEDED",
"errorMsg": "You have exceeded the maximum number of API calls. Please try again later."
}
Server error
{
"error_description": "Internal Server error, Please try again in a moment.",
"error_code": "COM0004"
}
![]()
Duration: 1 minute | Threshold: 60 | 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.