---
title: "Savemerchanttheme"
method: PUT
path: "/v2/giftcards/merchants/theme"
tags: ["Gift Card Merchants"]
---

# Savemerchanttheme

`PUT /v2/giftcards/merchants/theme`

Validate and persist the authenticated merchant's portal theme.

## Headers

- `X-Eposn-Merchant-Token` string, nullable

## Request body

- GiftCardMerchantTheme — Persisted merchant-facing theme configuration for the EPOSN portal.
  - `presetId` string
  - `primary` string
  - `primaryFg` string
  - `sidebarBg` string
  - `sidebarText` string
  - `sidebarActiveBg` string
  - `sidebarActiveText` string
  - `sidebarBadge` string
  - `background` string
  - `foreground` string
  - `surface` string
  - `border` string
  - `muted` string
  - `logoUrl` string, nullable
  - `logoAlt` string, nullable
  - `fontFamily` string, nullable
  - `borderRadius` 'none' | 'sm' | 'md' | 'lg' | 'full'

## Response `200`

Successful Response

- SaveMerchantThemeResponse
  - `theme` GiftCardMerchantTheme, required — Persisted merchant-facing theme configuration for the EPOSN portal.
    - `presetId` string
    - `primary` string
    - `primaryFg` string
    - `sidebarBg` string
    - `sidebarText` string
    - `sidebarActiveBg` string
    - `sidebarActiveText` string
    - `sidebarBadge` string
    - `background` string
    - `foreground` string
    - `surface` string
    - `border` string
    - `muted` string
    - `logoUrl` string, nullable
    - `logoAlt` string, nullable
    - `fontFamily` string, nullable
    - `borderRadius` 'none' | 'sm' | 'md' | 'lg' | 'full'
  - `validation` object, required
  - `performance` ThemePerformanceReport, required
    - `cssVarChanges` integer, required
    - `hasCustomFont` boolean, required
    - `hasLargeLogo` boolean, required
    - `issues` ThemePerformanceIssue[], required
      - `severity` string, required
      - `code` string, required
      - `message` string, required
      - `estimatedMs` integer, nullable
    - `score` integer, required

## Other responses

- `422` — Theme validation failed

---

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