Adds a new native messaging host. If a host with the same name already exists, returns the existing record.
post /bsp/api/v1/bmp/nativehost
https://{server-hostname}:8383/bsp/api/v1/bmp/nativehost
BrowserManager.CREATECopied!
Authorization: d92d4xxxxxxxxxxxxx15f52
JSON body with the native messaging host name to add
Native messaging host identifier to add. Must be a valid URL-safe string, max 2048 characters. If a host with the same name already exists, the existing record is returned.
curl --request POST \
--url https://appdomain/bsp/api/v1/bmp/nativehost \
--header 'Accept: application/json' \
--header 'Authorization: d92d4xxxxxxxxxxxxx15f52' \
--header 'Content-Type: application/json' \
--data '{"name":"com.example.nativehost"}'Add a new native messaging host for Chrome extensions
{
"name": "com.example.nativehost"
}
Add a Google Chrome remote desktop native host
{
"name": "com.google.chrome.remote_desktop"
}
Unique identifier for the native messaging host
Native messaging host identifier string (e.g., com.example.nativehost)
Unauthorized error code returned when authentication credentials are missing, expired, or invalid (authentication=required)
Authentication failure reason
Forbidden error code returned when the authenticated user does not have the required uem-roles (e.g., DataEncryption_Admin or DataEncryptionRecoveryKey_Admin)
Message indicating insufficient privileges to access this resource
Rate limit error code returned when the API call threshold (configured via threshold/duration in security XML) is exceeded; client is locked out for lock-period minutes
Rate limit exceeded message with retry guidance
Message describing the internal server error
Error code identifying the type of server error
Newly created native messaging host with assigned ID
{
"name": "com.example.nativehost",
"id": "1"
}
Host with same name already existed returns existing record
{
"name": "com.google.chrome.remote_desktop",
"id": "5"
}
Authentication credentials are missing or invalid
{
"errorCode": "UNAUTHORIZED",
"errorMsg": "You are not authorized to perform this action"
}
The user does not have the required permissions to perform this action
{
"errorCode": "FORBIDDEN",
"errorMsg": "You do not have permission to access this resource"
}
Too many API requests have been made
{
"errorCode": "RATE_LIMIT_EXCEEDED",
"errorMsg": "You have exceeded the maximum number of API calls. Please try again later."
}
An unexpected server error occurred
{
"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.
© 2026, Zoho Corporation Pvt. Ltd. All Rights Reserved.