---
title: "Test notification method"
method: POST
path: "/notification_methods/test"
tags: ["Notifications"]
---

# Test notification method

`POST /notification_methods/test`

Validate that the provided parameters allow sending a test notification.

Email: `value`=recipient email address. Slack: Incoming Webhook URL. Telegram: `value`=bot token, `second_value`=chat_id. Discord: Webhook URL. Webhook: sends a JSON payload to the provided URL.

## Request body

- NotificationMethodCreateRequest
  - `type` 'email' | 'slack' | 'telegram' | 'webhook' | 'discord', required
  - `value` string, required — Primary value (e.g., webhook URL, bot token, or email address).
  - `second_value` string, nullable — Secondary value when required by the method (e.g., Telegram chat_id).
  - `headers` WebhookCustomHeader[], nullable — Optional custom HTTP headers for webhook methods (max 10).
    - `name` string, required — HTTP header name.
    - `value` string, required — HTTP header value.
  - `extra_emails` string[], nullable — Up to 4 additional email recipients (delivered as BCC). Only allowed when type=email. Total recipients (value + extra_emails) must be ≤ 5.

## Response `200`

Test notification sent successfully.

- unknown

## Other responses

- `400` — Invalid parameters or delivery failed.
- `401` — Authentication required.
- `422` — Validation Error
- `429` — Rate limit exceeded (30 tests per hour).
- `500` — Internal error while sending the test notification.

---

[API](https://skmtc.dev/leakradar/apis/leakradar-io-api.md) · [All operations](https://skmtc.dev/leakradar/apis/leakradar-io-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/leakradar/leakradar-io-api/revisions/82a99c608e1a/schema)
