---
title: "Changes to Create a preference section"
method: POST
path: "/preferences/sections"
---

# Changes to Create a preference section

`POST /preferences/sections`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 4 of 55 revisions.

- **2026-07-29** `f76bed79a913` — 4 info
- **2026-07-09** `49e3cc128b6c` — 3 info
- **2026-06-26** `61131080b185` — 3 info
- **2026-06-24** `124a60dd716b` — 1 info

## Changes

- **2026-07-29** `f76bed79a913` — 4 info
  - api tag `Preference Topics` added
  - api tag `Workspace Preferences` removed
  - added the new optional `header` request parameter `Idempotency-Key`
  - added the new optional `header` request parameter `x-idempotency-expiration`
- **2026-07-09** `49e3cc128b6c` — 3 info
  - added the new optional request property `description`
  - added the optional property `description` to the response with the `201` status
  - added the optional property `topics/items/description` to the response with the `201` status
- **2026-06-26** `61131080b185` — 3 info
  - api operation id `preferenceSections_create` removed and replaced with `workspacePreferences_create`
  - api tag `Workspace Preferences` added
  - api tag `Preference Sections` removed
- **2026-06-24** `124a60dd716b` — 1 info
  - endpoint added

---

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