---
title: "testSendNotification"
method: POST
path: "/v2/integrations/{integrationId}/notifications/test"
tags: ["integrations"]
---

# testSendNotification

`POST /v2/integrations/{integrationId}/notifications/test`

Renders and sends ONE representative notification of the requested kind/type to
the CALLING USER ONLY (never any other recipient), so an operator can preview how
a notification looks. A test send does NOT write to the notification history.
Requires the `integration:manage` permission on the integration's organization.

## Path parameters

- `integrationId` string, uuid, required

## Request body

- TestNotificationRequest
  - `kind` 'alert' | 'digest', required — The kind of notification to render and send.
  - `type` string — The alert type to render when kind=alert (e.g. critical_error, error_threshold).
  - `channels` string[] — Delivery channels to use; defaults to the integration's configured channels.

## Response `202`

Test notification accepted for delivery to the calling user (sent is true)

- TestNotificationResponse
  - `sent` boolean, required — Whether the test notification was accepted for delivery.
  - `recipient` string, required — The calling user id the test was sent to (the only recipient).
  - `channels` string[], required — The channels the test was delivered on.
  - `notification_id` string, nullable — The svc-notification-api message id, or null when not returned.

## Other responses

- `400` — Bad request
- `401` — Unauthorized request
- `403` — Forbidden - insufficient permissions
- `404` — Resource not found
- `500` — Internal Server Error
- `502` — The downstream notification service rejected or failed the test send. The body uses TestNotificationResponse with sent set to false so the operator sees the real (failed) delivery outcome.

---

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