Notifications

Create notification method

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.

post/notification_methods

Request body

type'email' | 'slack' | 'telegram' | 'webhook' | 'discord' required
valuestring required

Primary value (e.g., webhook URL, bot token, or email address).

second_valuestring nullable

Secondary value when required by the method (e.g., Telegram chat_id).

extra_emailsstring[] nullable

Up to 4 additional email recipients (delivered as BCC). Only allowed when type=email. Total recipients (value + extra_emails) must be ≤ 5.

Example request

{
  "type": "email",
  "value": "alerts@example.com"
}

Response

Method created successfully.

idinteger required

Notification method ID.

type'email' | 'slack' | 'telegram' | 'webhook' | 'discord' required
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.

Changes

No recorded changes to this endpoint across all 1 revision of this API.