---
title: "Changes to Create Notification Template"
method: POST
path: "/notifications"
---

# Changes to Create Notification Template

`POST /notifications`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 6 of 55 revisions.

- **2026-08-10** `cb8586034158`: 3 breaking, 6 warning, 4 info
- **2026-07-29** `f76bed79a913`: 4 info
- **2026-07-20** `d2377425a729`: 2 breaking, 2 info
- **2026-04-14** `3f78581b4e07`: 5 breaking, 2 warning, 1 info
- **2026-04-13** `f0ac5c2fa86e`: 1 breaking, 1 info
- **2026-04-02** `b3dde9374868`: 1 info

## Changes

- **2026-08-10** `cb8586034158`: 3 breaking, 6 warning, 4 info
  - added `#/components/schemas/NotificationTemplatePayload, subschema #2: NotificationTemplateAliasWriteFields` to the `notification` request property `allOf` list
  - the `notification` request property type changed from `object` to no type
  - added `subschema #1, subschema #3, subschema #7` to the `allOf[subschema #1: NotificationTemplatePayload]/content/elements/items/` response property `oneOf` list for the response status `201`
  - removed the request property `notification/brand`
  - removed the request property `notification/content`
  - removed the request property `notification/name`
  - removed the request property `notification/routing`
  - removed the request property `notification/subscription`
  - removed the request property `notification/tags`
  - added `subschema #2: NotificationTemplateResponseFields` to the response body `allOf` list for the response status `201`
  - removed `subschema #2` from the response body `allOf` list for the response status `201`
  - added the non-success response with the status `409`
  - removed `subschema #1, subschema #3, subschema #7` from the `allOf[subschema #1: NotificationTemplatePayload]/content/elements/items/` response property `oneOf` list for the response status `201`
- **2026-07-29** `f76bed79a913`: 4 info
  - api tag `Templates` added
  - api tag `Notification Templates` removed
  - added the new optional `header` request parameter `Idempotency-Key`
  - added the new optional `header` request parameter `x-idempotency-expiration`
- **2026-07-20** `d2377425a729`: 2 breaking, 2 info
  - removed `subschema #4, subschema #5` from the `notification/content/elements/items/` request property `oneOf` list
  - added `subschema #4, subschema #5` to the `allOf[subschema #1: NotificationTemplatePayload]/content/elements/items/` response property `oneOf` list for the response status `201`
  - added `subschema #4, subschema #5` to the `notification/content/elements/items/` request property `oneOf` list
  - removed `subschema #4, subschema #5` from the `allOf[subschema #1: NotificationTemplatePayload]/content/elements/items/` response property `oneOf` list for the response status `201`
- **2026-04-14** `3f78581b4e07`: 5 breaking, 2 warning, 1 info
  - the response's body type changed from `object` to no type for status `201`
  - removed the required property `created` from the response with the `201` status
  - removed the required property `creator` from the response with the `201` status
  - removed the required property `notification` from the response with the `201` status
  - removed the required property `state` from the response with the `201` status
  - removed the optional property `updated` from the response with the `201` status
  - removed the optional property `updater` from the response with the `201` status
  - added `#/components/schemas/NotificationTemplatePayload, subschema #2` to the response body `allOf` list for the response status `201`
- **2026-04-13** `f0ac5c2fa86e`: 1 breaking, 1 info
  - removed the success response with the status `200`
  - added the success response with the status `201`
- **2026-04-02** `b3dde9374868`: 1 info
  - endpoint added

---

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