Skip to main content

Overview

The Webhook Configuration settings page lets you define HTTP endpoints that Rapydo will call when Alert Rules or Scout Rules trigger notifications. Each webhook can be configured with authentication, retry behavior, and SSL verification. Access this page from Settings → Webhook.

Webhook List

The main view shows a table of all configured webhooks with the following columns:
ColumnDescription
NameFriendly name for the webhook
URLThe target endpoint URL
MethodHTTP method (POST, PUT, or PATCH)
TypeSlack or Generic
Auth TypeAuthentication method (None, Bearer, Basic, or Custom)
ActiveWhether the webhook is enabled
ActionsEdit or Delete the webhook

Adding a Webhook

Click Add New Webhook Configuration to open the configuration panel. Fields are grouped into three sections.

Basic Configuration

FieldRequiredDescription
NameYesA descriptive name for the webhook (max 255 characters)
URLYesThe endpoint URL. Must use http:// or https://
HTTP MethodYesHow to call the endpoint: POST, PUT, or PATCH (default: POST)
Webhook TypeYesSlack — sends rich Block Kit formatted messages. Generic — sends a clean JSON payload suitable for PagerDuty, custom alerting systems, or any HTTP endpoint

Authentication

FieldDescription
Auth TypeChoose the authentication method: None, Bearer, Basic, or Custom (default: None)
Auth TokenShown when Auth Type is not None. Enter the token or credentials. Hidden by default with a show/hide toggle.
Security note: Auth tokens are write-only. After saving, the token is never returned by the API. When editing an existing webhook, leave the token field empty to keep the current token unchanged.

Advanced Settings

FieldDefaultRangeDescription
Timeout30 seconds1–300How long to wait for a response before considering the request failed
Retry Count30–10Number of retry attempts if the request fails
Retry Delay5 seconds1–60Delay between retry attempts
Verify SSL CertificateEnabledValidates the SSL certificate of the target URL. Disable only when testing with self-signed certificates

Testing a Webhook

Before saving, click Test to send a test request to the configured URL. The button shows a loading spinner while the request is in progress. Use this to confirm the endpoint is reachable and authentication is correct.

Editing a Webhook

Click Edit in the row actions menu to open the configuration panel pre-filled with the current settings. Make your changes and click Save.

Deleting a Webhook

Click Delete in the row actions menu to remove the webhook. Any Alert Rules or Scout Rules using this webhook will need to be updated to use a different notification destination.

Using Webhooks in Rules

Once configured, webhooks are available as notification destinations when creating:
  • Alert Rules — select the webhook under the Webhook notification option
  • Scout Rules — enter a webhook URL in the Notification section
See Alert Rules Reference and Scout Rules Reference for details.