Employer-level theming - Symmetry Docs

Use this endpoint to manage an application theme for a specific employer: /v1/employers/{employerId}/applicationTheme Employer-level themes apply only to the specified employer and take precedence over any account-level theme. They use the same custom_app_theme object as account-level themes—see Custom Theming for Embedded Experiences for the full list of supported properties. Use an employer-level theme when a single employer needs its own branding, when you support white-label or customer-specific designs, or when you need to override the account default for one employer without affecting the others.

Supported methods

Method	Behavior
`GET`	Retrieves the theme for the specified employer
`POST`	Applies a theme to the specified employer
`PATCH`	Partially updates the theme for the specified employer
`DELETE`	Removes the theme for the specified employer

Configuration structure

All theming customizations are defined in a single JSON object under custom_app_theme.

{
  "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. Any unsupported properties are ignored and do not affect the rendered embedded UI.

Examples

Retrieve theme for specific employer

Request

GET /v1/employers/{employerId}/applicationTheme

curl -X GET \
  "https://api.symmetry.com/i9/v1/employers/{employerId}/applicationTheme" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json"

Response

Returns the employer’s complete custom_app_theme object—the same structure shown in the account-level example.

Apply theme to specific employer

Use POST to create or fully replace an employer-level theme. The request body is the complete custom_app_theme object; see the account-level example for a full payload.

Request

POST /v1/employers/{employerId}/applicationTheme

{
  "custom_app_theme": {
    "body": { "fontSize": "14px", "color": "#525257" },
    "link": { "color": "#0a8080", "hoverColor": "#005c5c" }
  }
}

Response

The response returns the full theme as applied.

Partially update a theme

Use PATCH to update only the specified properties. All other existing theme values remain unchanged.

Request

PATCH /v1/employers/{employerId}/applicationTheme

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

Response

The response returns the complete theme with the updates applied.

Delete a theme

Removing an employer-level theme restores the Symmetry default styling for that employer. Because account-level themes are cascaded to each employer when you apply them rather than inherited at render time, deleting an employer’s theme does not restore the account-level theme. To put the account branding back, re-apply the account-level theme or POST the theme to that employer again.

Request

DELETE /v1/employers/{employerId}/applicationTheme

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

Response

A successful request returns HTTP 200 OK.

​Supported methods

​Configuration structure

​Examples

​Retrieve theme for specific employer

​Request

​Response

​Apply theme to specific employer

​Request

​Response

​Partially update a theme

​Request

​Response

​Delete a theme

​Request

​Response

Supported methods

Configuration structure

Examples

Retrieve theme for specific employer

Request

Response

Apply theme to specific employer

Request

Response

Partially update a theme

Request

Response

Delete a theme

Request

Response