Web messaging sdk colors not applying via api config

NICE CXone API & Integrations
1

Could someone explain why this payload does not change the launcher color? i am using the PUT /api/v2/webmessaging/deployments/{id} endpoint. docs state “use the customization object to override defaults” but the response 200 OK shows no change in ui.

{
“customization”: {
“launcher”: {
“position”: “bottom-right”,
“color”: “#FF0000”
}
}
}

nothing changes. am i missing a field?

2

This is caused by scope limitations in the deployment update. The customization object often requires explicit enabled: true for nested properties.

  1. Verify your OAuth token has webmessaging:deployment:write.
  2. Expand the payload to include all required customization fields, not just color.
  3. Check the response body for errors. A 200 OK might mask partial failures if the schema is loose.

Try this structure:

{
 "customization": {
 "launcher": {
 "enabled": true,
 "position": "bottom-right",
 "color": "#FF0000"
 }
 }
}