---
title: "Create a new brand"
method: POST
path: "/brands"
tags: ["Brands"]
---

# Create a new brand

`POST /brands`

Creates a brand from a name and settings, including primary and secondary colors. Brands supply the logo, colors, and styling that templates render with.

## Headers

- `Idempotency-Key` string
- `x-idempotency-expiration` string

## Request body

- BrandParameters
  - `id` string, nullable
  - `name` string, required
  - `settings` BrandSettings, required
    - `colors` BrandColors
      - `primary` string
      - `secondary` string
    - `email` BrandSettingsEmail
      - `templateOverride` BrandTemplateOverride
        - `backgroundColor` string, nullable
        - `blocksBackgroundColor` string, nullable
        - `enabled` boolean, required
        - `footer` string, nullable
        - `head` string, nullable
        - `header` string, nullable
        - `width` string, nullable
      - `head` EmailHead
        - `inheritDefault` boolean, required
        - `content` string, nullable
      - `footer` EmailFooter
        - `content` string, nullable
        - `inheritDefault` boolean, nullable
      - `header` EmailHeader
        - `inheritDefault` boolean, nullable
        - `barColor` string, nullable
        - `logo` Logo, required
          - `href` string, nullable
          - `image` string, nullable
    - `inapp` BrandSettingsInApp
      - `borderRadius` string, nullable
      - `disableMessageIcon` boolean, nullable
      - `fontFamily` string, nullable
      - `placement` 'top' | 'bottom' | 'left' | 'right'
      - `widgetBackground` WidgetBackground, required
        - `topColor` string, nullable
        - `bottomColor` string, nullable
      - `colors` BrandColors, required
        - `primary` string
        - `secondary` string
      - `icons` Icons, required
        - `bell` string, nullable
        - `message` string, nullable
  - `snippets` BrandSnippets
    - `items` BrandSnippet[], nullable
      - `name` string, required
      - `value` string, required

## Response `200`

- Brand
  - `id` string, required
  - `name` string, required
  - `published` integer, nullable
  - `created` integer, required
  - `updated` integer, required
  - `settings` BrandSettings
    - `colors` BrandColors
      - `primary` string
      - `secondary` string
    - `email` BrandSettingsEmail
      - `templateOverride` BrandTemplateOverride
        - `backgroundColor` string, nullable
        - `blocksBackgroundColor` string, nullable
        - `enabled` boolean, required
        - `footer` string, nullable
        - `head` string, nullable
        - `header` string, nullable
        - `width` string, nullable
      - `head` EmailHead
        - `inheritDefault` boolean, required
        - `content` string, nullable
      - `footer` EmailFooter
        - `content` string, nullable
        - `inheritDefault` boolean, nullable
      - `header` EmailHeader
        - `inheritDefault` boolean, nullable
        - `barColor` string, nullable
        - `logo` Logo, required
          - `href` string, nullable
          - `image` string, nullable
    - `inapp` BrandSettingsInApp
      - `borderRadius` string, nullable
      - `disableMessageIcon` boolean, nullable
      - `fontFamily` string, nullable
      - `placement` 'top' | 'bottom' | 'left' | 'right'
      - `widgetBackground` WidgetBackground, required
        - `topColor` string, nullable
        - `bottomColor` string, nullable
      - `colors` BrandColors, required
        - `primary` string
        - `secondary` string
      - `icons` Icons, required
        - `bell` string, nullable
        - `message` string, nullable
  - `snippets` BrandSnippets
    - `items` BrandSnippet[], nullable
      - `name` string, required
      - `value` string, required
  - `version` string, nullable

## Other responses

- `400`
- `402`
- `409`

---

[API](https://skmtc.net/trycourier/apis/courier.md) · [All operations](https://skmtc.net/trycourier/apis/courier/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/trycourier/courier/versions/04f69fbf96a5/schema)