---
title: "Changes to Create a new brand"
method: POST
path: "/brands"
---

# Changes to Create a new brand

`POST /brands`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 3 of 55 revisions.

- **2026-07-29** `f76bed79a913` — 2 info
- **2026-05-28** `4a6bb54f7975` — 2 breaking
- **2025-10-07** `7143ea51f307` — 25 breaking, 3 warning, 33 info

## Changes

- **2026-07-29** `f76bed79a913` — 2 info
  - added the new optional `header` request parameter `Idempotency-Key`
  - added the new optional `header` request parameter `x-idempotency-expiration`
- **2026-05-28** `4a6bb54f7975` — 2 breaking
  - the request property `settings` became not nullable
  - the request property `settings` became required
- **2025-10-07** `7143ea51f307` — 25 breaking, 3 warning, 33 info
  - added the new required request property `settings/email/header/logo`
  - added the new required request property `settings/inapp/colors`
  - added the new required request property `settings/inapp/icons`
  - added the new required request property `settings/inapp/widgetBackground`
  - the request property `settings/colors/primary` became not nullable
  - the request property `settings/colors/secondary` became not nullable
  - the `settings/email/footer` request property type/format changed from ``/`` to `object`/``
  - the `settings/email/header` request property type/format changed from ``/`` to `object`/``
  - the `settings/inapp` request property type/format changed from ``/`` to `object`/``
  - the response property `published` became nullable for the status `200`
  - the response property `settings` became nullable for the status `200`
  - the response property `settings/email/footer` became nullable for the status `200`
  - the response property `settings/email/header` became nullable for the status `200`
  - the response property `snippets/items` became nullable for the status `200`
  - the response property `version` became nullable for the status `200`
  - the response property `published` became optional for the status `200`
  - the response property `settings` became optional for the status `200`
  - the response property `settings/email/footer` became optional for the status `200`
  - the response property `settings/email/header` became optional for the status `200`
  - the response property `snippets/items` became optional for the status `200`
  - the response property `version` became optional for the status `200`
  - the `settings/email/footer` response's property type/format changed from ``/`` to `object`/`` for status `200`
  - the `settings/email/header` response's property type/format changed from ``/`` to `object`/`` for status `200`
  - the `settings/inapp` response's property type/format changed from ``/`` to `object`/`` for status `200`
  - removed the required property `snippets/items/items/format` from the response with the `200` status
  - removed the request property `settings/colors/tertiary`
  - removed the request property `snippets/items/items/format`
  - removed the optional property `settings/colors/tertiary` from the response with the `200` status
  - added the new optional request property `settings/email/footer/content`
  - added the new optional request property `settings/email/footer/inheritDefault`
  - added the new optional request property `settings/email/head`
  - added the new optional request property `settings/email/header/barColor`
  - added the new optional request property `settings/email/header/inheritDefault`
  - added the new optional request property `settings/email/templateOverride`
  - added the new optional request property `settings/inapp/borderRadius`
  - added the new optional request property `settings/inapp/disableMessageIcon`
  - added the new optional request property `settings/inapp/fontFamily`
  - added the new optional request property `settings/inapp/placement`
  - the request property `settings` became nullable
  - the request property `settings/email/footer` became nullable
  - …21 more

---

[Operation](https://skmtc.dev/trycourier/apis/courier/docs/brands/post.md) · [API](https://skmtc.dev/trycourier/apis/courier.md) · [Page](https://skmtc.dev/trycourier/apis/courier/changes/brands/post)