---
title: "Widget Theme"
method: GET
path: "/widget-theme/brand/{brandId}"
tags: ["Theme"]
---

# Widget Theme

`GET /widget-theme/brand/{brandId}`

Branding colors and CSS variables configured by the brand owner in the Optimove dashboard. Apply these to style your widget to match the brand's identity.

> 🚧 CSS safety
>
> `globalCss` and `customCss` are raw values from the API. Before injecting them as live styles, allow-list the CSS properties and selectors your widget accepts to prevent unintended style injection.

## Path parameters

- `brandId` string, uuid, required

## Response `200`

Theme configuration for the brand.

- WidgetTheme
  - `themeColors` object — Nested color palette. Keys are color names (e.g. `primary`), values are shade maps (`50` through `900`).
  - `globalCss` object — CSS property/value pairs to apply globally (e.g. border-radius, fonts).
  - `customCss` object — CSS selector/rule pairs for specific widget elements.
  - `customVariables` object — Named values (e.g. sizes, shadows) for use in your CSS as variables or constants.

---

[API](https://skmtc.net/optimove/apis/optimove-api.md) · [All operations](https://skmtc.net/optimove/apis/optimove-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/optimove/optimove-api/revisions/fc55c5b1bec5/schema)