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

# Create notification method

`POST /notification_methods`

Create a new notification method for the current account.

Body fields
- `type` one of: `email`, `slack`, `telegram`, `webhook`, `discord`.
- `value` string. For Slack/Discord use the webhook URL. For Telegram use the bot token.
- `second_value` optional. Required for Telegram (`chat_id`).

Response
Object with `id`, `type`, `value`, `second_value`, `timestamp`.

## 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`

Method created successfully.

- NotificationMethodOut
  - `id` integer, required — Notification method ID.
  - `type` 'email' | 'slack' | 'telegram' | 'webhook' | 'discord', required
  - `value` string, required — Primary destination (email address, webhook URL, channel ID, etc.).
  - `second_value` string, nullable — Secondary value (e.g. Telegram chat ID).
  - `headers` WebhookHeaderOut[], nullable — Custom HTTP headers for webhook methods.
    - `name` string, required
    - `value` string, nullable
  - `extra_emails` string[], nullable — Additional email recipients delivered as BCC (email methods only, max 4).
  - `timestamp` string, date-time, required — Creation date of this notification method.

## Other responses

- `401` — Authentication required.
- `403` — Feature not available on your plan (free tier restricts non-email channels and extra recipients).
- `422` — Validation error.

---

[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)