Account-level theming - Symmetry Docs

Account-level theming is the right choice when you serve multiple employers under one brand, when you prefer managing a theme centrally rather than employer by employer, or when you want to overwrite every existing employer theme at once. It is typically applied during onboarding.

Endpoint

Use this endpoint to manage an account-level application theme that cascades to all employers under your account: /v1/applicationTheme

Supported methods

Method	Behavior
`POST`	Applies a theme to all employers
`PATCH`	Partially updates the theme for all employers
`DELETE`	Removes the theme from all employers

Additional behavior:

Requests are rate-limited to 25 requests per second
Cascading updates are processed in parallel

The cascade reaches only the employers that are active when you apply the theme. Employers you activate afterward do not inherit it automatically. To bring a new employer in line, either re-apply the account-level theme with POST, or apply a theme directly to that employer.

Configuration structure

All theming customizations are defined within a single JSON object using the structure shown below:

{
  "custom_app_theme": {
    "alerts": {/* Notification styling with variants */},
    "body": {/* Body text styling */},
    "buttons": {/* Button styling with variants and states */},
    "formControl": {/* Input field styling */},
    "headings": {/* H1-H6 typography */},
    "link": {/* Link styling and hover states */}
  }
}

Each section supports a predefined set of properties. Properties outside the supported set are ignored and do not affect the rendered embedded UI. For the full list of customizable properties in each section, see Custom Theming for Embedded Experiences.

Examples

Apply a theme to all employers in your account

Use POST to create or fully replace the account-level application theme.

Request

POST /v1/applicationTheme

{
  "custom_app_theme": {
    "body": {
      "fontSize": "14px",
      "color": "#525257"
    },
    "link": {
      "hoverColor": "#005c5c",
      "hoverDecoration": "underline",
      "color": "#0a8080",
      "decoration": "underline"
    },
    "headings": {
      "h1": {
        "fontSize": "32px",
        "fontWeight": "500",
        "color": "#262626"
      },
      "h2": {
        "fontSize": "50px",
        "fontWeight": "500",
        "color": "#000fff"
      }
    },
    "alerts": {
      "borderWidth": "1px",
      "borderRadius": "4px",
      "variants": {
        "primary": {
          "backgroundColor": "#fdfcff",
          "borderColor": "#006cc1"
        },
        "danger": {
          "backgroundColor": "#fffbfb",
          "borderColor": "#c53336"
        }
      }
    },
    "buttons": {
      "borderRadius": "4px",
      "variants": {
        "primary": {
          "backgroundColor": "#0A8080",
          "activeBackgroundColor": "#005c5c"
        },
        "default": {
          "borderColor": "#1c1c1c"
        }
      }
    },
    "formControl": {
      "borderColor": "#929292",
      "borderRadius": "4px",
      "focusBorderColor": "#005c5c"
    }
  }
}

Response

The response returns the full theme as applied.

Partially update a theme

Use PATCH to update only the specified properties. All unspecified properties retain their existing values.

Request

PATCH /v1/applicationTheme

{
  "custom_app_theme": {
    "body": {
      "fontSize": "15px",
      "color": "#525257"
    }
  }
}

Response

The response returns the complete theme with the updates applied.

Delete a theme

Deleting the account-level theme causes the embedded UI to fall back to the Symmetry default theme.

Request

DELETE /v1/applicationTheme

curl -X DELETE "https://api.symmetry.com/i9/v1/applicationTheme" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json"

Response

A successful request returns HTTP 200 OK.

​Endpoint

​Supported methods

​Configuration structure

​Examples

​Apply a theme to all employers in your account

​Request

​Response

​Partially update a theme

​Request

​Response

​Delete a theme

​Request

​Response

Endpoint

Supported methods

Configuration structure

Examples

Apply a theme to all employers in your account

Request

Response

Partially update a theme

Request

Response

Delete a theme

Request

Response