Skip to main content
Version: 1.2

Custom Webhooks

Overview​

Custom Webhooks allow you to configure ToBeAlert to receive alerts from external systems in their native format. Instead of adapting your monitoring tools to ToBeAlert's format, you create a webhook that transforms incoming data into standardized alerts.

For detailed information about configuring custom webhooks, including field mappings, examples, and API documentation, see the Custom Webhooks API documentation.

Managing Custom Webhooks in the UI​

Creating a Custom Webhook​

  1. Navigate to Management → Custom Webhooks
  2. Click Create Webhook
  3. Fill in the configuration:
    • ID: Unique identifier for the webhook
    • Name: Descriptive name
    • Field Mappings: Define how to transform incoming data
    • Default Values: Set fallback values for missing fields
  4. Save the configuration

Testing Webhooks​

After creating a webhook:

  1. Click on the webhook in the list
  2. Copy the webhook URL
  3. Send test data to the URL
  4. Check the results in the alert table

Best Practices​

  • Use descriptive webhook IDs
  • Test with real data from your monitoring system
  • Monitor webhook health and error rates
  • Document your field mappings for your team