---
title: "Send Test Notification"
method: POST
path: "/v1/alerts/test-notification"
tags: ["Alerts"]
---

# Send Test Notification

`POST /v1/alerts/test-notification`

Send a test notification through the alert's configured channels.

## Headers

- `X-API-Key` string, required

## Request body

- TestNotificationRequest — Request model for sending a test alert notification.
  - `name` string, required — Alert name shown in the notification
  - `notification_channels` NotificationChannelRequest[], required — Channels to send the test to
    - `type` string, required — Type of notification: 'email', 'slack', 'webhook', or 'pagerduty'
    - `target` string, required — Target for the notification (email address, slack channel, webhook URL, or PagerDuty routing/integration key)
  - `alert_id` string, nullable — Existing alert id, so the notification links back to it

## Response `200`

Successful Response

- TestNotificationResponse
  - `queued` integer, required — Number of notification messages enqueued

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/getbluejay/apis/bluejay-api.md) · [All operations](https://skmtc.net/getbluejay/apis/bluejay-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/getbluejay/bluejay-api/revisions/f48cef80963f/schema)