Creates a new webdomain group with the specified name and description.
post /bsp/api/v1/bmp/webdomain-groups
https://{server-hostname}:8383/bsp/api/v1/bmp/webdomain-groups Copied!
Authorization: d92d4xxxxxxxxxxxxx15f52
JSON body with webdomain group name and description
Name for the webdomain group. Required, maximum 50 characters. Must be unique per customer
Description of the webdomain group purpose. Required, maximum 100 characters
curl --request POST \
--url https://appdomain/bsp/api/v1/bmp/webdomain-groups \
--header 'Accept: application/json' \
--header 'Authorization: d92d4xxxxxxxxxxxxx15f52' \
--header 'Content-Type: application/json' \
--data '{"webdomain_group_name":"Social Media Sites","description":"Group containing social media webdomains"}'Create webdomain group
{
"webdomain_group_name": "Social Media Sites",
"description": "Group containing social media webdomains"
}
Unique identifier for the webdomain group
Display name of the webdomain group. Maximum 50 characters
Description of the webdomain group. Maximum 100 characters
Username of the user who originally created this group
Group creation timestamp in milliseconds since epoch
Username of the user who last modified this group
Last modification timestamp in milliseconds since epoch
Webdomains associated with this group. Empty for newly created groups
Unique identifier for the webdomain
Webdomain display name
Unique identifier for the webdomain
Webdomain display name
Message describing the validation failure, such as name length exceeded or duplicate group name
Error code for the validation failure. Absent for duplicate name errors
Unauthorized error code: API key or OAuth token missing, expired or invalid
Authentication failure reason
Forbidden error code: the user lacks the required MDM_OSUpdateMgmt UEM role
Message indicating insufficient privileges
Rate limit error code: API call threshold exceeded for this endpoint group
Rate limit exceeded message with retry guidance
Message describing the internal server error
Error code identifying the type of server error
Created group
{
"created_time": 1741651200000,
"last_modified_time": 1741651200000,
"webdomain_group_id": 100,
"webdomain_group_name": "Social Media Sites",
"description": "Group containing social media webdomains",
"last_modified_by": "admin",
"available_webdomains": [],
"created_by": "admin"
}
Name length exceeded
{
"error_description": "Name length exceeded",
"error_code": "BSP_COM0001"
}
Required parameter below minimum usage
{
"errorCode": "IAM0021",
"url": "/bsp/api/v1/bmp/webdomain-groups/{web_domain_id}",
"errorMsg": "The number of times the parameter webdomain_group_name used is below the minimum requirement."
}
Unauthorized
{
"errorCode": "UNAUTHORIZED",
"errorMsg": "You are not authorized to perform this action"
}
Insufficient permissions
{
"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.