Adds a routing payload to a Draft profile, mapping URLs or web domain groups to a target browser.
https://{server-hostname}:8383/bsp/api/v1/bmp/browser_router/{profile_id}/router_payloads
BrowserManager.CREATECopied!
Authorization: d92d4xxxxxxxxxxxxx15f52
Browser Router Profile ID from List Browser Router Profiles response (profile_id field)
JSON body with a router_payloads object containing the routing rule: target browser (open_in), optional browser mode, URL entries with webdomain IDs, and/or group entries with group IDs
curl --request POST \
--url https://appdomain/bsp/api/v1/bmp/browser_router/{profile_id}/router_payloads \
--header 'Accept: application/json' \
--header 'Authorization: d92d4xxxxxxxxxxxxx15f52' \
--header 'Content-Type: application/json' \
--data '{"router_payloads":{"urls":[{"webdomain_ids":["21"],"doc_type":""}],"groups":[{"ids":["313"],"doc_type":""}],"intranet_zone":false,"open_in":"chrome"}}'Route URLs and groups to Google Chrome. open_in: target browser, set to chrome. urls.webdomain_ids: array of pre-created webdomain IDs to route. urls.doc_type: IE document compatibility mode, set to empty string as IE mode is not applicable for Chrome. groups.ids: array of pre-created webdomain group IDs to route. groups.doc_type: IE document compatibility mode for the group, set to empty string. intranet_zone: whether to include local intranet zone sites in this rule.
{
"router_payloads": {
"urls": [
{
"webdomain_ids": [
"21"
],
"doc_type": ""
}
],
"groups": [
{
"ids": [
"313"
],
"doc_type": ""
}
],
"intranet_zone": false,
"open_in": "chrome"
}
}
curl --request POST \
--url https://appdomain/bsp/api/v1/bmp/browser_router/{profile_id}/router_payloads \
--header 'Accept: application/json' \
--header 'Authorization: d92d4xxxxxxxxxxxxx15f52' \
--header 'Content-Type: application/json' \
--data '{"router_payloads":{"urls":[{"webdomain_ids":["17"],"doc_type":""}],"groups":[{"ids":["313"],"doc_type":""}],"intranet_zone":false,"open_in":"firefox"}}'Route URLs and groups to Mozilla Firefox. open_in: target browser, set to firefox. urls.webdomain_ids: array of pre-created webdomain IDs to route. urls.doc_type: IE document compatibility mode, set to empty string as IE mode is not applicable for Firefox. groups.ids: array of pre-created webdomain group IDs to route. groups.doc_type: IE document compatibility mode for the group, set to empty string. intranet_zone: whether to include local intranet zone sites in this rule.
{
"router_payloads": {
"urls": [
{
"webdomain_ids": [
"17"
],
"doc_type": ""
}
],
"groups": [
{
"ids": [
"313"
],
"doc_type": ""
}
],
"intranet_zone": false,
"open_in": "firefox"
}
}
curl --request POST \
--url https://appdomain/bsp/api/v1/bmp/browser_router/{profile_id}/router_payloads \
--header 'Accept: application/json' \
--header 'Authorization: d92d4xxxxxxxxxxxxx15f52' \
--header 'Content-Type: application/json' \
--data '{"router_payloads":{"urls":[{"webdomain_ids":["17"],"doc_type":"IE8Enterprise"}],"browser_mode":"IEModeInEdge","groups":[{"ids":["313"],"doc_type":"IE8Enterprise"}],"intranet_zone":false,"open_in":"chromiumEdge"}}'Route URLs and groups to Microsoft Edge with IE compatibility rendering. open_in: target browser, set to chromiumEdge (Microsoft Edge). browser_mode: set to IEModeInEdge to render pages in IE mode within Edge. urls.webdomain_ids: array of pre-created webdomain IDs to route. urls.doc_type: IE document compatibility mode for these URLs (e.g. IE8Enterprise, IE11, IE10, IE9, IE8, IE7, IE5). groups.ids: array of pre-created webdomain group IDs to route. groups.doc_type: IE document compatibility mode for the group. intranet_zone: whether to include local intranet zone sites in this rule.
{
"router_payloads": {
"urls": [
{
"webdomain_ids": [
"17"
],
"doc_type": "IE8Enterprise"
}
],
"browser_mode": "IEModeInEdge",
"groups": [
{
"ids": [
"313"
],
"doc_type": "IE8Enterprise"
}
],
"intranet_zone": false,
"open_in": "chromiumEdge"
}
}
curl --request POST \
--url https://appdomain/bsp/api/v1/bmp/browser_router/{profile_id}/router_payloads \
--header 'Accept: application/json' \
--header 'Authorization: d92d4xxxxxxxxxxxxx15f52' \
--header 'Content-Type: application/json' \
--data '{"router_payloads":{"urls":[{"webdomain_ids":["3"],"doc_type":"IE11"}],"groups":[{"ids":["15"],"doc_type":"IE11"}],"intranet_zone":false,"open_in":"chromiumEdge"}}'Route URLs and groups to Microsoft Edge without IE compatibility mode. open_in: target browser, set to chromiumEdge (Microsoft Edge). browser_mode: omitted, so pages render in Edge's default Chromium rendering engine. urls.webdomain_ids: array of pre-created webdomain IDs to route. urls.doc_type: IE document compatibility mode for these URLs. groups.ids: array of pre-created webdomain group IDs to route. groups.doc_type: IE document compatibility mode for the group. intranet_zone: whether to include local intranet zone sites in this rule.
{
"router_payloads": {
"urls": [
{
"webdomain_ids": [
"3"
],
"doc_type": "IE11"
}
],
"groups": [
{
"ids": [
"15"
],
"doc_type": "IE11"
}
],
"intranet_zone": false,
"open_in": "chromiumEdge"
}
}
curl --request POST \
--url https://appdomain/bsp/api/v1/bmp/browser_router/{profile_id}/router_payloads \
--header 'Accept: application/json' \
--header 'Authorization: d92d4xxxxxxxxxxxxx15f52' \
--header 'Content-Type: application/json' \
--data '{"router_payloads":{"urls":[{"webdomain_ids":["10"],"doc_type":"IE8Enterprise"}],"groups":[{"ids":["25"],"doc_type":"IE8Enterprise"}],"intranet_zone":false,"open_in":"iexplorer"}}'Route URLs and groups to Internet Explorer. open_in: target browser, set to iexplorer (Internet Explorer). urls.webdomain_ids: array of pre-created webdomain IDs to route. urls.doc_type: IE document compatibility mode for these URLs (e.g. IE8Enterprise, IE11, IE10, IE9, IE8, IE7, IE5). groups.ids: array of pre-created webdomain group IDs to route. groups.doc_type: IE document compatibility mode for the group. intranet_zone: whether to include local intranet zone sites in this rule.
{
"router_payloads": {
"urls": [
{
"webdomain_ids": [
"10"
],
"doc_type": "IE8Enterprise"
}
],
"groups": [
{
"ids": [
"25"
],
"doc_type": "IE8Enterprise"
}
],
"intranet_zone": false,
"open_in": "iexplorer"
}
}
Created payload configurations with routing details
Payload type. 64100 for Browser Router
Unique identifier of the payload
Routing rule configurations
Unique identifier for this configuration data item
URL routing rules with webdomain details
Document compatibility mode. Values: IE11, IE10, IE9, IE8, IE8Enterprise, IE7, IE5, or empty string for default rendering
Unique identifier of the webdomain
The URL or hostname pattern for this routing rule
Webdomain group routing rules
Unique identifier of the webdomain group
Display name of the webdomain group
Document compatibility mode for the group. Values: IE11, IE10, IE9, IE8, IE8Enterprise, IE7, IE5, or empty string for default rendering
Browser rendering mode. Values: IEModeInEdge, Default
Whether to include intranet zone sites in this routing rule
Target browser to open matching URLs. Values: chromiumEdge, chrome, firefox, iexplorer
Configuration label
Name of the duplicate webdomain or group already assigned to another payload
Error code for duplicate webdomain/group assignment
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
Message indicating the specified profile or payload was not found
Message indicating published profiles cannot be modified
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 server-side failure
Internal server error code
Created payload (Edge IE Mode)
{
"router_payload": [
{
"payload_type": "64100",
"payload_id": "622",
"router_details": [
{
"config_data_item_id": "622",
"urls": [
{
"doc_type": "IE11",
"id": "601",
"url": "localhost"
}
],
"groups": [
{
"group_id": "618",
"webdomain_group": "Corporate Intranet Sites",
"doc_type": "IE5"
}
],
"browser_mode": "IEModeInEdge",
"intranet_zone": false,
"open_in": "chromiumEdge"
}
],
"config_label": "BROWSER_ROUTER"
}
]
}
Duplicate webdomain
{
"error_description": "example.com",
"error_code": "BSP_BR0001"
}
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"
}
Profile not found
{
"error_description": "Profile not found"
}
Profile is published
{
"error_description": "Cannot modify a published profile"
}
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.
© 2026, Zoho Corporation Pvt. Ltd. All Rights Reserved.