Alerting Quickstart Guide
This quick start guide shows you how to configure a Successful Transaction alert to send a notification about successful transactions coming to and from a wallet.
Step 1: Launch the Alerts setup wizard
Alerts landing page
From the left-hand menu, click on Alerts to launch the Alerts setup. From here, you can create new Alerts or manage existing ones.
To create a new Alert, click the New Alert button, which will open up the Alert configuration settings.
Alert set up wizard
To set up a Successful Transaction alert or any other alert, you need to configure four components:
- Alert Type: The event you want the Alert to listen for and send you a notification when it happens. Tenderly supports 12 Alert Types.
- Alert Target: Here, you tell Tenderly which addresses you want to monitor. The Target options are the same across all Alert Types.
- Alert Parameters: Based on the Target, this is where you select the specific address(es) you want to monitor along with other settings specific to the Alert Type.
- Alert Destinations: Location where you want to receive notifications when the event occurs.
Step 2: Choose the Successful Transaction Alert Type
From the list of available Alert Types, select Successful Transaction to monitor when a successful transaction happens.
Available Alert trigger types
Some Alert Types are self-explanatory, while others are more nuanced, so please refer to the Alert Trigger Types documentation page for detailed explanations of each.
Step 3: Set the Alert Target to Address
The Alert Target section is where you tell Tenderly which address(es) you’d like to monitor and where they are located.
The available Target options are the same for all Alert Types and include:
- Address: Monitor a single smart contract or wallet
- Network: Monitor all transactions on a specific network
- Project: Monitor all addresses that are part of your Tenderly Project
- Tag: Monitor all contracts and wallets labeled with the specific tag
In our case, we’ll choose Address because we want to monitor a single address of our wallet.
Available Alert Targets
Step 4: Set the wallet address as the Target Parameter
With the Target set to Address, we need to tell Tenderly which wallet address we want to monitor. Tenderly will pull all the smart contracts and wallets associated with your project and display them in a dropdown.
If you haven’t added any smart contracts or wallets to your Tenderly Project, follow these quick guides to learn how to add a wallet or a smart contract.
From the dropdown, we’ll select the address of the Tenderly Wallet.
List of smart contracts and wallets associated with the project
Step 5: Choose Email as the Alert Destination
To keep things simple, we want to receive an email notification informing us about successful transactions coming to and from our Tenderly Wallet.
Select Email as the Alert Destination and fill out the required details, including the email address. If you’re adding a new email address, you’ll have to confirm that you’re the owner to be able to receive notifications there.
Setting Email as the Alert Destination
When a Successful Transaction event occurs on our wallet, Tenderly will send us an email notification with important information about the event and links to Tenderly Dashboard to inspect it further.
Email notification from Tenderly
In addition to email, you can also receive notifications in your favorite messaging app:
*Click on the link for each destination to learn how to set it up.
Or you can send alert data to other Tenderly systems:
Or third-party incident and error monitoring platforms like:
With the Alert Destination all set, click Save to create and enable the Alert.
Notifications from a single Alert can be sent to multiple Destinations. Likewise, you can have multiple Alerts send notifications to a single Destination. Once you add a Destination for the first time, it can be used by Alerts you create in the future.
Step 6: Managing Alerts and Destinations
All deployed Alerts can be managed from the Rules view. Next to the Alert you want to manage, click on the three dots to reveal additional options: Enable/Disable, Duplicate, Edit, or Remove.
Managing an existing Alert
If you click on History in the top menu, you can view when and how many times your Alerts were executed.
History of Alert execution
And if you navigate to the Destinations tab, you can manage all previously created Destinations or create new ones.
Once you create a Destination, it will be accessible from all your projects, so you don’t have to create the same Destination in another project.
The exception is Web3 Actions as the Alert Destination. This Destination is visible only under the project it was created.
If you edit or delete a Destination, the changes will be applied across all your projects and active rules.
List of created Alert Destinations
Wrapping up
In this guide, you learned how to set up and configure a Successful Transaction alert that sends an email notification about all successful transactions coming to and from a wallet.