---
title: "Changes to Create a notification channel (admin/superadmin)"
method: POST
path: "/notifications"
---

# Changes to Create a notification channel (admin/superadmin)

`POST /notifications`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 9 of 82 revisions.

- **2026-10-01** `e1e4b18d0319`: 3 breaking, 3 warning, 5 info
- **2026-10-01** `35ce9d674857`: 1 breaking, 18 info
- **2026-09-12** `18b49d155064`: 2 info
- **2026-08-18** `f0f3ae56f5c5`: 3 info
- **2026-08-02** `eae6c896648e`: 2 info
- **2026-05-27** `dd1708803c7c`: 2 info
- **2026-05-01** `39082d385dda`: 2 breaking, 6 warning, 8 info
- **2025-08-11** `db719f9e3d34`: 1 info
- **2025-04-20** `b97ec6888b3c`: 1 breaking

## Changes

- **2026-10-01** `e1e4b18d0319`: 3 breaking, 3 warning, 5 info
  - removed the required property `success` from the response with the `401` status
  - removed the required property `success` from the response with the `403` status
  - removed the required property `success` from the response with the `500` status
  - removed the optional property `data` from the response with the `401` status
  - removed the optional property `data` from the response with the `403` status
  - removed the optional property `data` from the response with the `500` status
  - added the non-success response with the status `400`
  - added the non-success response with the status `429`
  - added the required property `status` to the response with the `401` status
  - added the required property `status` to the response with the `403` status
  - added the required property `status` to the response with the `500` status
- **2026-10-01** `35ce9d674857`: 1 breaking, 18 info
  - the `data` response's property type changed from no type to `object` for status `200`
  - added the optional property `data/accessToken` to the response with the `200` status
  - added the optional property `data/accountSid` to the response with the `200` status
  - added the optional property `data/address` to the response with the `200` status
  - added the optional property `data/homeserverUrl` to the response with the `200` status
  - added the optional property `data/ntfyAuthType` to the response with the `200` status
  - added the optional property `data/ntfyUsername` to the response with the `200` status
  - added the optional property `data/phone` to the response with the `200` status
  - added the optional property `data/roomId` to the response with the `200` status
  - added the optional property `data/topic` to the response with the `200` status
  - added the optional property `data/twilioPhoneNumber` to the response with the `200` status
  - the response property `data` became required for the status `200`
  - added the required property `data/createdAt` to the response with the `200` status
  - added the required property `data/id` to the response with the `200` status
  - added the required property `data/notificationName` to the response with the `200` status
  - added the required property `data/teamId` to the response with the `200` status
  - added the required property `data/type` to the response with the `200` status
  - added the required property `data/updatedAt` to the response with the `200` status
  - added the required property `data/userId` to the response with the `200` status
- **2026-09-12** `18b49d155064`: 2 info
  - added `signalgrid` mapping keys to the request discriminator
  - added `#/components/schemas/SignalgridNotification` to the request body `oneOf` list
- **2026-08-18** `f0f3ae56f5c5`: 3 info
  - added the new optional request property `oneOf[#/components/schemas/NtfyNotification]/accessToken`
  - added the new optional request property `oneOf[#/components/schemas/NtfyNotification]/ntfyAuthType`
  - added the new optional request property `oneOf[#/components/schemas/NtfyNotification]/ntfyUsername`
- **2026-08-02** `eae6c896648e`: 2 info
  - added `rocket_chat` mapping keys to the request discriminator
  - added `#/components/schemas/RocketChatNotification` to the request body `oneOf` list
- **2026-05-27** `dd1708803c7c`: 2 info
  - added `ntfy` mapping keys to the request discriminator
  - added `#/components/schemas/NtfyNotification` to the request body `oneOf` list
- **2026-05-01** `39082d385dda`: 2 breaking, 6 warning, 8 info
  - the request's body type changed from `object` to no type
  - removed the success response with the status `201`
  - removed the request property `config`
  - removed the request property `isActive`
  - removed the request property `name`
  - removed the request property `type`
  - removed the optional property `details` from the response with the `500` status
  - added the new `false` enum value to the `success` response property for the response status `500`
  - request body became optional
  - added request discriminator
  - added `#/components/schemas/EmailNotification, #/components/schemas/WebhookNotification, #/components/schemas/SlackNotification, #/components/schemas/DiscordNotification, #/components/schemas/PagerDutyNotification, #/components/schemas/MatrixNotification, #/components/schemas/TeamsNotification, #/components/schemas/TelegramNotification, #/components/schemas/PushoverNotification, #/components/schemas/TwilioNotification` to the request body `oneOf` list
  - added the non-success response with the status `401`
  - added the non-success response with the status `403`
  - removed the non-success response with the status `422`
  - added the optional property `data` to the response with the `500` status
  - added the success response with the status `200`
- **2025-08-11** `db719f9e3d34`: 1 info
  - endpoint added
- **2025-04-20** `b97ec6888b3c`: 1 breaking
  - api path removed without deprecation

---

[Operation](https://skmtc.dev/bluewave-labs/apis/checkmate-api/docs/notifications/post.md) - [API](https://skmtc.dev/bluewave-labs/apis/checkmate-api.md) - [Page](https://skmtc.dev/bluewave-labs/apis/checkmate-api/changes/notifications/post)