How to Use Webhooks for Alerting
Learn how to create your first webhook and start receiving alerting events.
Welcome to this guide on how to create a webhook as an alert destination to receive events from an alerting service. In this guide, you will learn how to set up a webhook and see its execution.
Once logged in, create a new Tenderly project or select an existing one where you want to create your Webhook.
From the left-hand menu, go to Alerts -> Destinations tab, where you'll see a list of all the available destinations.
Navigating to the Destination section
To create a webhook alert destination, click on the Webhook card, which will open up the configuration modal. You'll be prompted to configure the following options:
- Webhook name - Must be unique and cannot be changed later
- Webhook URL - URL where you'll receive live events from Tenderly
- Description - Optional parameter, but you can use it to provide more information about the webhook configuration
Add Webhook Modal
Webhook Modal Advanced Configuration Modal
To test if the provided URL is able to receive events from Tenderly, click on the Send test webhook button, and the predefined test payload will be sent to your endpoint.
Send Test Webhook
If everything works as expected and you've received the event, click on the Add Webhook button. This action will add the new webhook destination to the Active Destinations list.
New Webhook is added to the active destinations list
Clicking on the button to the right will open up the Webhook overview page. This is where you can find information about the webhook status, URL, creation date, signing secrets, etc.
You also perform other actions on your webhooks, such as enabling/disabling a webhook, or make changes to the existing configuration.
Enable/Disable Webhook: Toggle the status of a webhook between active and inactive.
Delete Webhook: Remove a webhook from your Tenderly project. Deleting a webhook is a permanent action and cannot be undone.
Send a Test Request: Test the functionality of your webhook by sending a test event to the provided URL by providing a transaction hash with its network.
Test Webhook Modal
Edit Webhook: Modify the configuration of an existing webhook, such as the URL or description.
Edit Webhook Modal
From the webhook overview page, click on Execution History to see the transaction payload that has been sent to the provided webhook URL and the response from the webhook endpoint.
Manually Triggered Webhook After Clicking on Test Webhook Button
Webhook execution can have several statuses:
- Success: Webhook was successfully executed, and the event was delivered to the specified URL.
- Failed: Webhook was unable to be executed due to an error, such as a connectivity issue, a problem with the URL, or something else. Check the response content to see what caused the error, or contact our support.
- Pending: Webhook is in the process of being executed and has not yet been completed.
- Retry: Webhook execution failed but will be retried no more than 5 times until it changes the status to Sucess or Failed.
- Skipped: Webhook was not executed because it was disabled.
Webhook Execution Page
You can also see prior webhook executions by applying different filters, such as Filter by Status and Select a Date Range.
Webhook Execution History Page
Select Webhook Status Dropdown
Select Date Range Dropdown
With your webhook endpoint configured, you can add it as a Destination to any of your Alerts.
Adding a Webhook as a Destination to the Alert Rule
When you create an Alert rule, you'll be redirected to the following page:
Alert Rule with a Webhook as a Destination
If your Alert is enabled, you'll start receiving events to your webhook endpoint.
Webhook Execution History Page
In this example, we used https://webhook.site to create a temporary webhook endpoint to test how Tenderly webhooks work. Below is an image of the payload successfully sent to the webhook.
Successful Webhook Executions
Last modified 1mo ago