---
title: "Send a test alert through a single notification channel"
method: POST
path: "/notifications/test"
tags: ["notifications"]
---

# Send a test alert through a single notification channel

`POST /notifications/test`

## Request body

- union
  - EmailNotification
    - `notificationName` string, required
    - `type` 'email', required
    - `address` string, email, required
    - `homeserverUrl` union
      - string
      - ''
    - `roomId` union
      - string
      - ''
    - `accessToken` union
      - string
      - ''
  - WebhookNotification
    - `notificationName` string, required
    - `type` 'webhook', required
    - `address` string, uri, required
    - `homeserverUrl` union
      - string
      - ''
    - `roomId` union
      - string
      - ''
    - `accessToken` union
      - string
      - ''
  - RocketChatNotification
    - `notificationName` string, required
    - `type` 'rocket_chat', required
    - `address` string, uri, required
  - SlackNotification
    - `notificationName` string, required
    - `type` 'slack', required
    - `address` string, uri, required
    - `homeserverUrl` union
      - string
      - ''
    - `roomId` union
      - string
      - ''
    - `accessToken` union
      - string
      - ''
  - DiscordNotification
    - `notificationName` string, required
    - `type` 'discord', required
    - `address` string, uri, required
    - `homeserverUrl` union
      - string
      - ''
    - `roomId` union
      - string
      - ''
    - `accessToken` union
      - string
      - ''
  - PagerDutyNotification
    - `notificationName` string, required
    - `type` 'pager_duty', required
    - `address` string, required
    - `homeserverUrl` union
      - string
      - ''
    - `roomId` union
      - string
      - ''
    - `accessToken` union
      - string
      - ''
  - MatrixNotification
    - `notificationName` string, required
    - `type` 'matrix', required
    - `address` union
      - string
      - ''
    - `homeserverUrl` string, uri, required
    - `roomId` string, required
    - `accessToken` string, required
  - TeamsNotification
    - `notificationName` string, required
    - `type` 'teams', required
    - `address` string, uri, required
  - TelegramNotification
    - `notificationName` string, required
    - `type` 'telegram', required
    - `address` string, required
    - `accessToken` string, required
  - PushoverNotification
    - `notificationName` string, required
    - `type` 'pushover', required
    - `address` string, required
    - `accessToken` string, required
  - TwilioNotification
    - `notificationName` string, required
    - `type` 'twilio', required
    - `accountSid` string, required
    - `accessToken` string, required
    - `phone` string, required
    - `twilioPhoneNumber` string, required
  - NtfyNotification
    - `notificationName` string, required
    - `type` 'ntfy', required
    - `address` string, uri, required
    - `topic` string, required
    - `ntfyAuthType` 'none' | 'token' | 'basic'
    - `ntfyUsername` union
      - string
      - ''
    - `accessToken` union
      - string
      - ''

## Response `200`

OK

- object
  - `success` true, required
  - `msg` string, required
  - `data` object, required
    - `success` boolean, required

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `500` — Internal server error

## Changes

- **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` — 3 warning, 6 info
  - 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`
  - added the new `true` enum value to the `success` response property for the response status `200`
  - added optional request body
  - …5 more
- **2025-08-11** `db719f9e3d34` — 1 info
  - endpoint added

[Full history](https://skmtc.dev/bluewave-labs/apis/checkmate-api/changes/notifications/test/post.md)

---

[API](https://skmtc.dev/bluewave-labs/apis/checkmate-api.md) · [All operations](https://skmtc.dev/bluewave-labs/apis/checkmate-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bluewave-labs/checkmate-api/revisions/a9ac59e12c59/schema)