---
title: "Create or update domain theme"
method: POST
path: "/domains/theme/{domainId}"
tags: ["Domains"]
---

# Create or update domain theme

`POST /domains/theme/{domainId}`

## Request

- Base URL: `https://api.short.io`
- URL: `https://api.short.io/domains/theme/{domainId}`
- Auth: API key in header `Authorization`

Creates or updates theme settings for the domain. Colors are 6- or 8-character hex strings without the leading `#` (RRGGBB, or RRGGBBAA for transparency).

## Path parameters

- `domainId` integer, required

## Request body

- object
  - `primaryColor` string, nullable: 6 or 8-character hex color without # prefix (RRGGBB or RRGGBBAA)
  - `secondaryColor` string, nullable: 6 or 8-character hex color without # prefix (RRGGBB or RRGGBBAA)
  - `backgroundColor` string, nullable: 6 or 8-character hex color without # prefix (RRGGBB or RRGGBBAA)
  - `contentBgColor` string, nullable: 6 or 8-character hex color without # prefix (RRGGBB or RRGGBBAA)
  - `textColor` string, nullable: 6 or 8-character hex color without # prefix (RRGGBB or RRGGBBAA)
  - `headingColor` string, nullable: 6 or 8-character hex color without # prefix (RRGGBB or RRGGBBAA)
  - `linkColor` string, nullable: 6 or 8-character hex color without # prefix (RRGGBB or RRGGBBAA)
  - `buttonTextColor` string, nullable: 6 or 8-character hex color without # prefix (RRGGBB or RRGGBBAA)
  - `fontFamily` string, nullable: CSS font-family for themed pages
  - `customProperties` object, nullable: Custom CSS variable key/value pairs

## Response `200`

Default Response

---

[API](https://skmtc.dev/short/apis/short-io-api-2.md) · [All operations](https://skmtc.dev/short/apis/short-io-api-2/llms.txt) · [OpenAPI document](https://skmtc.dev/short/apis/short-io-api-2/revisions/9e4e60c560b1?raw)