---
title: "Create a theme"
method: POST
path: "/api/v1/themes"
tags: ["Themes"]
---

# Create a theme

`POST /api/v1/themes`

Creates a new theme for the operator. Image fields accept base64-encoded data URLs (`data:image/png;base64,...`); supported MIME types are `image/png`, `image/jpeg`, `image/svg+xml`; maximum 4 MB per image. <br>Required scope: `themes:write` </br>Organization authorization: `supported`

## Request body

- ThemeCreate
  - `name` string, required — Name of the theme
  - `default` boolean
  - `sidebar_theming_enabled` boolean — Whether sidebar theming is enabled
  - `app_primary_color` string, required — Primary colour for the app
  - `app_secondary_color` string, required — Secondary colour for the app
  - `portal_primary_color` string, required — Primary colour for the portal
  - `portal_secondary_color` string, required — Secondary colour for the portal
  - `app_image` string, required — App logo as a base64-encoded data URL. Allowed MIME types: image/png, image/jpeg, image/svg+xml. Max 4 MB.
  - `portal_image` string, required — Portal logo as a base64-encoded data URL.
  - `portal_fav_icon` string, required — Portal favicon as a base64-encoded data URL.

## Response `200`

Created theme

- ThemeDto
  - `id` integer — Unique identifier of the theme
  - `name` string, required — Name of the theme
  - `title` string, required — Title of the theme formatted with operator name
  - `primaryColor` string, required — Primary color in HEX format
  - `secondaryColor` string, required — Secondary color in HEX format
  - `logoUrl` string, required — Url of the logo image
  - `favIconUrl` string, required — Url of the favicon image
  - `operator` ThemeOperatorDto, required
    - `id` integer — Operator id
    - `identifier` string, required — Operator identifier
    - `themingEnabled` boolean — Indicates if theming is enabled for the operator

## Other responses

- `400` — The request is invalid
- `401` — Consumer with provided credentials was not found
- `403` — Operator doesn't have access to resource
- `404` — Entity with the provided id was not found

---

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