Associates published configuration profiles to computer groups for deployment. Supports up to 1000 profiles and 1000 groups per request.
post /bsp/api/v1/bmp/profiles/groups
https://{serverurl}/bsp/api/v1/bmp/profiles/groups
Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52
JSON body containing profile_ids and group_ids arrays for profile-to-group association. Optionally exclude specific groups or devices from the distribution target.
Request body for associating profiles to groups
Computer group IDs from List Computer Groups response (group_id field). Max 100
Profile IDs from List Profiles response (profile_id field). Max 100, only published profiles allowed
Optional. Computer group IDs from List Computer Groups response to exclude from profile distribution. Same source as group_ids
Optional. Device IDs from List Devices response to exclude from distribution
curl --request POST \
--url https://appdomains/bsp/api/v1/bmp/profiles/groups \
--header 'Accept: application/json' \
--header 'Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52' \
--header 'Content-Type: application/json' \
--data '{}'Associate a profile to two computer groups
{
"group_ids": [
100,
103
],
"profile_ids": [
111
]
}
Associate a profile to groups while excluding specific devices and groups
{
"exclude_group_ids": [
105
],
"group_ids": [
100,
103
],
"exclude_device_ids": [
301,
302
],
"profile_ids": [
111
]
}
Bad request error for invalid input or constraint violations
Error code identifying the specific validation failure
Message describing the validation failure
Unauthorized error code: credentials missing, expired, or invalid
Authentication failure reason
Error code indicating insufficient permissions
Message indicating insufficient privileges to access this resource
Conflict error due to the current state of the profile
Conflict error message
Rate limit error code returned when the API call reached threshold
Rate limit exceeded message with retry guidance
Internal server error response for profile operations
Error message describing the server failure
Error code for internal server errors
Returns 204 No Content on success.
204 Returns 204 No Content on success.Invalid request parameters or incompatible profile type for user-type group
{
"errorcode": "IAM0003",
"errormsg": "Invalid request."
}
API key is missing or invalid
{
"errorCode": "IAM0001",
"errorMsg": "Authentication key is invalid. Please regenerate the key and try again."
}
Forbidden
{
"errorCode": "FORBIDDEN",
"errorMsg": "User does not have permission to perform this operation"
}
The specified profile does not exist or is in trash
{
"errormsg": "Profile not found"
}
Profile must be published before association
{
"errormsg": "Profile is not published."
}
Rate limit exceeded
{
"errorCode": "RATE_LIMIT_EXCEEDED",
"errorMsg": "Too many requests. Please try again after 5 minutes"
}
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.