---
title: "POST /accounts/{AwsAccountId}/themes/{ThemeId}"
method: POST
path: "/accounts/{AwsAccountId}/themes/{ThemeId}"
---

# POST /accounts/{AwsAccountId}/themes/{ThemeId}

`POST /accounts/{AwsAccountId}/themes/{ThemeId}`

Creates a theme.

A _theme_ is set of configuration options for color and layout. Themes apply to analyses and dashboards. For more information, see [Using Themes in Amazon QuickSight](https://docs.aws.amazon.com/quicksight/latest/user/themes-in-quicksight.html) in the _Amazon QuickSight User Guide_.

## Path parameters

- `AwsAccountId` string, required
- `ThemeId` string, required

## Request body

- object
  - `Name` string, required — A display name for the theme.
  - `BaseThemeId` string, required — The ID of the theme that a custom theme will inherit from. All themes inherit from one of the starting themes defined by Amazon QuickSight. For a list of the starting themes, use <code>ListThemes</code> or choose <b>Themes</b> from within an analysis.
  - `VersionDescription` string — A description of the first version of the theme that you're creating. Every time <code>UpdateTheme</code> is called, a new version is created. Each version of the theme has a description of the version in the <code>VersionDescription</code> field.
  - `Configuration` object, required — The theme configuration. This configuration contains all of the display properties for a theme.
    - `DataColorPalette` object — Color properties that apply to chart data colors.
      - `Colors` HexColor[] — The hexadecimal codes for the colors.
      - `MinMaxGradient` HexColor[] — The minimum and maximum hexadecimal codes that describe a color gradient.
      - `EmptyFillColor` string — The hexadecimal code of a color that applies to charts where a lack of data is highlighted.
    - `UIColorPalette` object — Color properties that apply to the UI and to charts, excluding the colors that apply to data.
      - `PrimaryForeground` string — The color of text and other foreground elements that appear over the primary background regions, such as grid lines, borders, table banding, icons, and so on.
      - `PrimaryBackground` string — The background color that applies to visuals and other high emphasis UI.
      - `SecondaryForeground` string — The foreground color that applies to any sheet title, sheet control text, or UI that appears over the secondary background.
      - `SecondaryBackground` string — The background color that applies to the sheet background and sheet controls.
      - `Accent` string — This color is that applies to selected states and buttons.
      - `AccentForeground` string — The foreground color that applies to any text or other elements that appear over the accent color.
      - `Danger` string — The color that applies to error messages.
      - `DangerForeground` string — The foreground color that applies to any text or other elements that appear over the error color.
      - `Warning` string — This color that applies to warning and informational messages.
      - `WarningForeground` string — The foreground color that applies to any text or other elements that appear over the warning color.
      - `Success` string — The color that applies to success messages, for example the check mark for a successful download.
      - `SuccessForeground` string — The foreground color that applies to any text or other elements that appear over the success color.
      - `Dimension` string — The color that applies to the names of fields that are identified as dimensions.
      - `DimensionForeground` string — The foreground color that applies to any text or other elements that appear over the dimension color.
      - `Measure` string — The color that applies to the names of fields that are identified as measures.
      - `MeasureForeground` string — The foreground color that applies to any text or other elements that appear over the measure color.
    - `Sheet` object — Display options related to sheets.
      - `Tile` object — The display options for tiles.
        - `Border` object — The border around a tile.
          - `Show` boolean — The option to enable display of borders for visuals.
      - `TileLayout` object — The layout options for tiles.
        - `Gutter` object — The gutter settings that apply between tiles.
          - `Show` boolean — This Boolean value controls whether to display a gutter space between sheet tiles.
        - `Margin` object — The margin settings that apply around the outside edge of sheets.
          - `Show` boolean — This Boolean value controls whether to display sheet margins.
    - `Typography` Typography — Determines the typography options.
      - `FontFamilies` Font[] — Determines the list of font families.
        - `FontFamily` string — Determines the font family settings.
  - `Permissions` ResourcePermission[] — A valid grouping of resource permissions to apply to the new theme.
    - `Principal` string, required — <p>The Amazon Resource Name (ARN) of the principal. This can be one of the following:</p> <ul> <li> <p>The ARN of an Amazon QuickSight user or group associated with a data source or dataset. (This is common.)</p> </li> <li> <p>The ARN of an Amazon QuickSight user, group, or namespace associated with an analysis, dashboard, template, or theme. (This is common.)</p> </li> <li> <p>The ARN of an Amazon Web Services account root: This is an IAM ARN rather than a QuickSight ARN. Use this option only to share resources (templates) across Amazon Web Services accounts. (This is less common.) </p> </li> </ul>
    - `Actions` String[], required — The IAM action to grant or revoke permissions on.
  - `Tags` Tag[] — A map of the key-value pairs for the resource tag or tags that you want to add to the resource.
    - `Key` string, required — Tag key.
    - `Value` string, required — Tag value.

## Response `200`

Success

- CreateThemeResponse
  - `Arn` string — The Amazon Resource Name (ARN) for the theme.
  - `VersionArn` string — The Amazon Resource Name (ARN) for the new theme.
  - `ThemeId` string — The ID of the theme.
  - `CreationStatus` 'CREATION_IN_PROGRESS' | 'CREATION_SUCCESSFUL' | 'CREATION_FAILED' | 'UPDATE_IN_PROGRESS' | 'UPDATE_SUCCESSFUL' | 'UPDATE_FAILED' | 'DELETED' — The theme creation status.
  - `Status` integer — The HTTP status of the request.
  - `RequestId` string — The Amazon Web Services request ID for this operation.

## Other responses

- `480` — AccessDeniedException
- `481` — InvalidParameterValueException
- `482` — ResourceExistsException
- `483` — ResourceNotFoundException
- `484` — ThrottlingException
- `485` — UnsupportedUserEditionException
- `486` — LimitExceededException
- `487` — InternalFailureException

---

[API](https://skmtc.net/aws/apis/quicksight.md) · [All operations](https://skmtc.net/aws/apis/quicksight/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/quicksight/versions/2f2bbd7e70ca/schema)