Notifications

List notification methods

Changed on

Return all notification methods configured for the current account.

Method types

  • email
  • slack (Incoming Webhook URL)
  • telegram (value = bot token, second_value = chat_id)
  • webhook (generic HTTP webhook)
  • discord (Discord Webhook URL)

Response Array of objects with id, type, name, value, second_value, timestamp, and the delivery health: status (active, suspended after repeated failed deliveries, or paused), consecutive_failures, failing_since, last_failure_at, last_success_at, last_error.

get/notification_methods

Request

Response

Notification methods listed successfully.

idinteger required

Notification method ID.

type'email' | 'slack' | 'telegram' | 'webhook' | 'discord' required
namestring nullable

User-given label of this channel, null when unnamed.

valuestring required

Primary destination (email address, webhook URL, channel ID, etc.).

second_valuestring nullable

Secondary value (e.g. Telegram chat ID).

extra_emailsstring[] nullable

Additional email recipients delivered as BCC (email methods only, max 4).

timestampstring date-time required

Creation date of this notification method.

status'active' | 'suspended' | 'paused'

Delivery state. active: alerts are delivered. suspended: deliveries kept failing, so LeakRadar stopped sending; it retries every few hours and resumes on the first delivery that goes through. paused: paused by you. Alerts using a suspended or paused method keep running; their results stay in the monitoring history.

suspended_atstring date-time nullable

When the method was suspended or paused.

consecutive_failuresinteger

Failed deliveries in a row that prove the destination is broken (gone, refused or down), since the last successful one.

failing_sincestring date-time nullable

First failure of the current streak.

last_failure_atstring date-time nullable

Last failed delivery.

last_success_atstring date-time nullable

Last successful delivery, test sends included.

last_errorstring nullable

Why the last delivery failed.

Changes

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status