---
title: "Update notification method"
method: PATCH
path: "/notification_methods/{method_id}"
tags: ["Notifications"]
---

# Update notification method

`PATCH /notification_methods/{method_id}`

Update an existing notification method owned by the current account.

**Errors**
- 401 Authentication required.
- 404 Notification method not found.
- 422 Request validation error.

## Path parameters

- `method_id` integer, required — ID of the notification method.

## 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 updated 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.
- `404` — Notification method not found.
- `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)